Value wrapper API. More...

#include <glib.h>

Include dependency graph for value.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	PurpleValue
	A wrapper for a type, subtype, and specific type of value. More...

Enumerations
enum	PurpleType { PURPLE_TYPE_UNKNOWN = 0 , PURPLE_TYPE_SUBTYPE , PURPLE_TYPE_CHAR , PURPLE_TYPE_UCHAR , PURPLE_TYPE_BOOLEAN , PURPLE_TYPE_SHORT , PURPLE_TYPE_USHORT , PURPLE_TYPE_INT , PURPLE_TYPE_UINT , PURPLE_TYPE_LONG , PURPLE_TYPE_ULONG , PURPLE_TYPE_INT64 , PURPLE_TYPE_UINT64 , PURPLE_TYPE_STRING , PURPLE_TYPE_OBJECT , PURPLE_TYPE_POINTER , PURPLE_TYPE_ENUM , PURPLE_TYPE_BOXED }
	Specific value types. More...

enum	PurpleSubType { PURPLE_SUBTYPE_UNKNOWN = 0 , PURPLE_SUBTYPE_ACCOUNT , PURPLE_SUBTYPE_BLIST , PURPLE_SUBTYPE_BLIST_BUDDY , PURPLE_SUBTYPE_BLIST_GROUP , PURPLE_SUBTYPE_BLIST_CHAT , PURPLE_SUBTYPE_BUDDY_ICON , PURPLE_SUBTYPE_CONNECTION , PURPLE_SUBTYPE_CONVERSATION , PURPLE_SUBTYPE_PLUGIN , PURPLE_SUBTYPE_BLIST_NODE , PURPLE_SUBTYPE_CIPHER , PURPLE_SUBTYPE_STATUS , PURPLE_SUBTYPE_LOG , PURPLE_SUBTYPE_XFER , PURPLE_SUBTYPE_SAVEDSTATUS , PURPLE_SUBTYPE_XMLNODE , PURPLE_SUBTYPE_USERINFO , PURPLE_SUBTYPE_STORED_IMAGE , PURPLE_SUBTYPE_CERTIFICATEPOOL , PURPLE_SUBTYPE_CHATBUDDY }
	Purple-specific subtype values. More...

Functions
PurpleValue *	purple_value_new (PurpleType type,...)
	Creates a new PurpleValue.

PurpleValue *	purple_value_new_outgoing (PurpleType type,...)
	Creates a new outgoing PurpleValue.

void	purple_value_destroy (PurpleValue *value)
	Destroys a PurpleValue.

PurpleValue *	purple_value_dup (const PurpleValue *value)
	Duplicated a PurpleValue.

PurpleType	purple_value_get_type (const PurpleValue *value)
	Returns a value's type.

unsigned int	purple_value_get_subtype (const PurpleValue *value)
	Returns a value's subtype.

const char *	purple_value_get_specific_type (const PurpleValue *value)
	Returns a value's specific type.

gboolean	purple_value_is_outgoing (const PurpleValue *value)
	Returns whether or not the value is an outgoing value.

void	purple_value_set_char (PurpleValue *value, char data)
	Sets the value's character data.

void	purple_value_set_uchar (PurpleValue *value, unsigned char data)
	Sets the value's unsigned character data.

void	purple_value_set_boolean (PurpleValue *value, gboolean data)
	Sets the value's boolean data.

void	purple_value_set_short (PurpleValue *value, short data)
	Sets the value's short integer data.

void	purple_value_set_ushort (PurpleValue *value, unsigned short data)
	Sets the value's unsigned short integer data.

void	purple_value_set_int (PurpleValue *value, int data)
	Sets the value's integer data.

void	purple_value_set_uint (PurpleValue *value, unsigned int data)
	Sets the value's unsigned integer data.

void	purple_value_set_long (PurpleValue *value, long data)
	Sets the value's long integer data.

void	purple_value_set_ulong (PurpleValue *value, unsigned long data)
	Sets the value's unsigned long integer data.

void	purple_value_set_int64 (PurpleValue *value, gint64 data)
	Sets the value's 64-bit integer data.

void	purple_value_set_uint64 (PurpleValue *value, guint64 data)
	Sets the value's unsigned 64-bit integer data.

void	purple_value_set_string (PurpleValue value, const char data)
	Sets the value's string data.

void	purple_value_set_object (PurpleValue value, void data)
	Sets the value's object data.

void	purple_value_set_pointer (PurpleValue value, void data)
	Sets the value's pointer data.

void	purple_value_set_enum (PurpleValue *value, int data)
	Sets the value's enum data.

void	purple_value_set_boxed (PurpleValue value, void data)
	Sets the value's boxed data.

char	purple_value_get_char (const PurpleValue *value)
	Returns the value's character data.

unsigned char	purple_value_get_uchar (const PurpleValue *value)
	Returns the value's unsigned character data.

gboolean	purple_value_get_boolean (const PurpleValue *value)
	Returns the value's boolean data.

short	purple_value_get_short (const PurpleValue *value)
	Returns the value's short integer data.

unsigned short	purple_value_get_ushort (const PurpleValue *value)
	Returns the value's unsigned short integer data.

int	purple_value_get_int (const PurpleValue *value)
	Returns the value's integer data.

unsigned int	purple_value_get_uint (const PurpleValue *value)
	Returns the value's unsigned integer data.

long	purple_value_get_long (const PurpleValue *value)
	Returns the value's long integer data.

unsigned long	purple_value_get_ulong (const PurpleValue *value)
	Returns the value's unsigned long integer data.

gint64	purple_value_get_int64 (const PurpleValue *value)
	Returns the value's 64-bit integer data.

guint64	purple_value_get_uint64 (const PurpleValue *value)
	Returns the value's unsigned 64-bit integer data.

const char *	purple_value_get_string (const PurpleValue *value)
	Returns the value's string data.

void *	purple_value_get_object (const PurpleValue *value)
	Returns the value's object data.

void *	purple_value_get_pointer (const PurpleValue *value)
	Returns the value's pointer data.

int	purple_value_get_enum (const PurpleValue *value)
	Returns the value's enum data.

void *	purple_value_get_boxed (const PurpleValue *value)
	Returns the value's boxed data.

Detailed Description

Value wrapper API.

Definition in file value.h.

Enumeration Type Documentation

◆ PurpleSubType

enum PurpleSubType

Purple-specific subtype values.

Definition at line 61 of file value.h.

◆ PurpleType

enum PurpleType

Specific value types.

Enumerator
PURPLE_TYPE_UNKNOWN	Unknown type.
PURPLE_TYPE_SUBTYPE	Subtype.
PURPLE_TYPE_CHAR	Character.
PURPLE_TYPE_UCHAR	Unsigned character.
PURPLE_TYPE_BOOLEAN	Boolean.
PURPLE_TYPE_SHORT	Short integer.
PURPLE_TYPE_USHORT	Unsigned short integer.
PURPLE_TYPE_INT	Integer.
PURPLE_TYPE_UINT	Unsigned integer.
PURPLE_TYPE_LONG	Long integer.
PURPLE_TYPE_ULONG	Unsigned long integer.
PURPLE_TYPE_INT64	64-bit integer.
PURPLE_TYPE_UINT64	64-bit unsigned integer.
PURPLE_TYPE_STRING	String.
PURPLE_TYPE_OBJECT	Object pointer.
PURPLE_TYPE_POINTER	Generic pointer.
PURPLE_TYPE_ENUM	Enum.
PURPLE_TYPE_BOXED	Boxed pointer with specific type.

Definition at line 34 of file value.h.

Function Documentation

◆ purple_value_destroy()

void purple_value_destroy ( PurpleValue * value )

Destroys a PurpleValue.

Parameters

value The value to destroy.

◆ purple_value_dup()

PurpleValue * purple_value_dup ( const PurpleValue * value )

Duplicated a PurpleValue.

Parameters

value The value to duplicate.

Returns: The duplicate value.

◆ purple_value_get_boolean()

gboolean purple_value_get_boolean ( const PurpleValue * value )

Returns the value's boolean data.

Parameters

value The value.

Returns: The boolean data.

◆ purple_value_get_boxed()

void * purple_value_get_boxed ( const PurpleValue * value )

Returns the value's boxed data.

Parameters

value The value.

Returns: The boxed data.

◆ purple_value_get_char()

char purple_value_get_char ( const PurpleValue * value )

Returns the value's character data.

Parameters

value The value.

Returns: The character data.

◆ purple_value_get_enum()

int purple_value_get_enum ( const PurpleValue * value )

Returns the value's enum data.

Parameters

value The value.

Returns: The enum data.

◆ purple_value_get_int()

int purple_value_get_int ( const PurpleValue * value )

Returns the value's integer data.

Parameters

value The value.

Returns: The integer data.

◆ purple_value_get_int64()

gint64 purple_value_get_int64 ( const PurpleValue * value )

Returns the value's 64-bit integer data.

Parameters

value The value.

Returns: The 64-bit integer data.

◆ purple_value_get_long()

long purple_value_get_long ( const PurpleValue * value )

Returns the value's long integer data.

Parameters

value The value.

Returns: The long integer data.

◆ purple_value_get_object()

void * purple_value_get_object ( const PurpleValue * value )

Returns the value's object data.

Parameters

value The value.

Returns: The object data.

◆ purple_value_get_pointer()

void * purple_value_get_pointer ( const PurpleValue * value )

Returns the value's pointer data.

Parameters

value The value.

Returns: The pointer data.

◆ purple_value_get_short()

short purple_value_get_short ( const PurpleValue * value )

Returns the value's short integer data.

Parameters

value The value.

Returns: The short integer data.

◆ purple_value_get_specific_type()

const char * purple_value_get_specific_type ( const PurpleValue * value )

Returns a value's specific type.

If the value's type is not PURPLE_TYPE_BOXED, this will return NULL.

Parameters

value The value whose specific type you want.

Returns: The value's specific type, or NULL if not PURPLE_TYPE_BOXED.

◆ purple_value_get_string()

const char * purple_value_get_string ( const PurpleValue * value )

Returns the value's string data.

Parameters

value The value.

Returns: The string data.

◆ purple_value_get_subtype()

unsigned int purple_value_get_subtype ( const PurpleValue * value )

Returns a value's subtype.

If the value's type is not PURPLE_TYPE_SUBTYPE, this will return 0. Subtypes should never have a subtype of 0.

Parameters

value The value whose subtype you want.

Returns: The value's subtype, or 0 if type is not PURPLE_TYPE_SUBTYPE.

◆ purple_value_get_type()

PurpleType purple_value_get_type ( const PurpleValue * value )

Returns a value's type.

Parameters

value The value whose type you want.

Returns: The value's type.

◆ purple_value_get_uchar()

unsigned char purple_value_get_uchar ( const PurpleValue * value )

Returns the value's unsigned character data.

Parameters

value The value.

Returns: The unsigned character data.

◆ purple_value_get_uint()

unsigned int purple_value_get_uint ( const PurpleValue * value )

Returns the value's unsigned integer data.

Parameters

value The value.

Returns: The unsigned integer data.

◆ purple_value_get_uint64()

guint64 purple_value_get_uint64 ( const PurpleValue * value )

Returns the value's unsigned 64-bit integer data.

Parameters

value The value.

Returns: The unsigned 64-bit integer data.

◆ purple_value_get_ulong()

unsigned long purple_value_get_ulong ( const PurpleValue * value )

Returns the value's unsigned long integer data.

Parameters

value The value.

Returns: The unsigned long integer data.

◆ purple_value_get_ushort()

unsigned short purple_value_get_ushort ( const PurpleValue * value )

Returns the value's unsigned short integer data.

Parameters

value The value.

Returns: The unsigned short integer data.

◆ purple_value_is_outgoing()

gboolean purple_value_is_outgoing ( const PurpleValue * value )

Returns whether or not the value is an outgoing value.

Parameters

value The value.

Returns: TRUE if the value is outgoing, or FALSE otherwise.

◆ purple_value_new()

PurpleValue * purple_value_new	(	PurpleType	type,
			...
	)

Creates a new PurpleValue.

This function takes a type and, depending on that type, a sub-type or specific type.

If type is PURPLE_TYPE_BOXED, the next parameter must be a string representing the specific type.

If type is PURPLE_TYPE_SUBTYPE, the next parameter must be a integer or enum representing the sub-type.

If the subtype or specific type is not set when required, random errors may occur. You have been warned.

Parameters

type The type.

Returns: The new value.

◆ purple_value_new_outgoing()

PurpleValue * purple_value_new_outgoing	(	PurpleType	type,
			...
	)

Creates a new outgoing PurpleValue.

If a value is an "outgoing" value it means the value can be modified by plugins and scripts.

This function takes a type and, depending on that type, a sub-type or specific type.

If type is PURPLE_TYPE_BOXED, the next parameter must be a string representing the specific type.

If type is PURPLE_TYPE_SUBTYPE, the next parameter must be a integer or enum representing the sub-type.

If the sub-type or specific type is not set when required, random errors may occur. You have been warned.

Parameters

type The type.

Returns: The new value.

◆ purple_value_set_boolean()

void purple_value_set_boolean	(	PurpleValue *	value,
		gboolean	data
	)

Sets the value's boolean data.

Parameters

value	The value.
data	The boolean data.

◆ purple_value_set_boxed()

void purple_value_set_boxed	(	PurpleValue *	value,
		void *	data
	)

Sets the value's boxed data.

Parameters

value	The value.
data	The boxed data.

◆ purple_value_set_char()

void purple_value_set_char	(	PurpleValue *	value,
		char	data
	)

Sets the value's character data.

Parameters

value	The value.
data	The character data.

◆ purple_value_set_enum()

void purple_value_set_enum	(	PurpleValue *	value,
		int	data
	)

Sets the value's enum data.

Parameters

value	The value.
data	The enum data.

◆ purple_value_set_int()

void purple_value_set_int	(	PurpleValue *	value,
		int	data
	)

Sets the value's integer data.

Parameters

value	The value.
data	The integer data.

◆ purple_value_set_int64()

void purple_value_set_int64	(	PurpleValue *	value,
		gint64	data
	)

Sets the value's 64-bit integer data.

Parameters

value	The value.
data	The 64-bit integer data.

◆ purple_value_set_long()

void purple_value_set_long	(	PurpleValue *	value,
		long	data
	)

Sets the value's long integer data.

Parameters

value	The value.
data	The long integer data.

◆ purple_value_set_object()

void purple_value_set_object	(	PurpleValue *	value,
		void *	data
	)

Sets the value's object data.

Parameters

value	The value.
data	The object data.

◆ purple_value_set_pointer()

void purple_value_set_pointer	(	PurpleValue *	value,
		void *	data
	)

Sets the value's pointer data.

Parameters

value	The value.
data	The pointer data.

◆ purple_value_set_short()

void purple_value_set_short	(	PurpleValue *	value,
		short	data
	)

Sets the value's short integer data.

Parameters

value	The value.
data	The short integer data.

◆ purple_value_set_string()

void purple_value_set_string	(	PurpleValue *	value,
		const char *	data
	)

Sets the value's string data.

Parameters

value	The value.
data	The string data.

◆ purple_value_set_uchar()

void purple_value_set_uchar	(	PurpleValue *	value,
		unsigned char	data
	)

Sets the value's unsigned character data.

Parameters

value	The value.
data	The unsigned character data.

◆ purple_value_set_uint()

void purple_value_set_uint	(	PurpleValue *	value,
		unsigned int	data
	)

Sets the value's unsigned integer data.

Parameters

value	The value.
data	The unsigned integer data.

◆ purple_value_set_uint64()

void purple_value_set_uint64	(	PurpleValue *	value,
		guint64	data
	)

Sets the value's unsigned 64-bit integer data.

Parameters

value	The value.
data	The unsigned 64-bit integer data.

◆ purple_value_set_ulong()

void purple_value_set_ulong	(	PurpleValue *	value,
		unsigned long	data
	)

Sets the value's unsigned long integer data.

Parameters

value	The value.
data	The unsigned long integer data.

◆ purple_value_set_ushort()

void purple_value_set_ushort	(	PurpleValue *	value,
		unsigned short	data
	)

Sets the value's unsigned short integer data.

Parameters

value	The value.
data	The unsigned short integer data.

Data Structures

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

◆ PurpleSubType

◆ PurpleType

Function Documentation

◆ purple_value_destroy()

◆ purple_value_dup()

◆ purple_value_get_boolean()

◆ purple_value_get_boxed()

◆ purple_value_get_char()

◆ purple_value_get_enum()

◆ purple_value_get_int()

◆ purple_value_get_int64()

◆ purple_value_get_long()

◆ purple_value_get_object()

◆ purple_value_get_pointer()

◆ purple_value_get_short()

◆ purple_value_get_specific_type()

◆ purple_value_get_string()

◆ purple_value_get_subtype()

◆ purple_value_get_type()

◆ purple_value_get_uchar()

◆ purple_value_get_uint()

◆ purple_value_get_uint64()

◆ purple_value_get_ulong()

◆ purple_value_get_ushort()

◆ purple_value_is_outgoing()

◆ purple_value_new()

◆ purple_value_new_outgoing()

◆ purple_value_set_boolean()

◆ purple_value_set_boxed()

◆ purple_value_set_char()

◆ purple_value_set_enum()

◆ purple_value_set_int()

◆ purple_value_set_int64()

◆ purple_value_set_long()

◆ purple_value_set_object()

◆ purple_value_set_pointer()

◆ purple_value_set_short()

◆ purple_value_set_string()

◆ purple_value_set_uchar()

◆ purple_value_set_uint()

◆ purple_value_set_uint64()

◆ purple_value_set_ulong()

◆ purple_value_set_ushort()