GalagoValue

GalagoValue — Generic data type container.

Synopsis




                    GalagoValue;
enum                GalagoType;
GalagoValue*        galago_value_new                    (GalagoType type,
                                                         const void *data,
                                                         void *detail);
GalagoValue*        galago_value_new_object             (GType type,
                                                         const GObject *obj);
GalagoValue*        galago_value_new_list               (GalagoType type,
                                                         GList *list,
                                                         void *detail);
GalagoValue*        galago_value_new_array              (GalagoType type,
                                                         const void *array,
                                                         gsize size,
                                                         void *detail);
void                galago_value_destroy                (GalagoValue *value);
GalagoType          galago_value_get_type               (const GalagoValue *value);
GalagoType          galago_value_get_subtype            (const GalagoValue *value);
GType               galago_value_get_gtype              (const GalagoValue *value);
void                galago_value_set_char               (GalagoValue *value,
                                                         char data);
void                galago_value_set_uchar              (GalagoValue *value,
                                                         unsigned char data);
void                galago_value_set_boolean            (GalagoValue *value,
                                                         gboolean data);
void                galago_value_set_short              (GalagoValue *value,
                                                         short data );
void                galago_value_set_ushort             (GalagoValue *value,
                                                         short data );
void                galago_value_set_int                (GalagoValue *value,
                                                         int data);
void                galago_value_set_uint               (GalagoValue *value,
                                                         unsigned int data);
void                galago_value_set_long               (GalagoValue *value,
                                                         long data );
void                galago_value_set_ulong              (GalagoValue *value,
                                                         long data );
void                galago_value_set_string             (GalagoValue *value,
                                                         const char *data);
void                galago_value_set_object             (GalagoValue *value,
                                                         void *data);
void                galago_value_set_pointer            (GalagoValue *value,
                                                         void *data);
void                galago_value_set_list               (GalagoValue *value,
                                                         GList *data);
void                galago_value_set_array              (GalagoValue *value,
                                                         const void *data,
                                                         gsize size);
char                galago_value_get_char               (const GalagoValue *value);
unsigned char       galago_value_get_uchar              (const GalagoValue *value);
gboolean            galago_value_get_boolean            (const GalagoValue *value);
short               galago_value_get_short              (const GalagoValue *value);
unsigned short      galago_value_get_ushort             (const GalagoValue *value);
int                 galago_value_get_int                (const GalagoValue *value);
unsigned int        galago_value_get_uint               (const GalagoValue *value);
long                galago_value_get_long               (const GalagoValue *value);
unsigned long       galago_value_get_ulong              (const GalagoValue *value);
const char*         galago_value_get_string             (const GalagoValue *value);
void*               galago_value_get_object             (const GalagoValue *value);
void*               galago_value_get_pointer            (const GalagoValue *value);
GList*              galago_value_get_list               (const GalagoValue *value);
void                galago_value_get_array              (const GalagoValue *value,
                                                         const void **ret_array,
                                                         gsize *ret_size);

Description

This is a generic data type container, similar in ways to GValue. It was originally written before libgalago was glib-based. It will go away in time, to be replaced with GValue. Currently, this is used only in the D-BUS utility functions.

Details

GalagoValue

typedef struct _GalagoValue GalagoValue;


enum GalagoType

typedef enum
{
	GALAGO_VALUE_TYPE_UNKNOWN = 0,  /* Unknown type.            */
	GALAGO_VALUE_TYPE_CHAR,         /* Character.               */
	GALAGO_VALUE_TYPE_UCHAR,        /* Unsigned character.      */
	GALAGO_VALUE_TYPE_BOOLEAN,      /* Boolean.                 */
	GALAGO_VALUE_TYPE_SHORT,        /* Short integer.           */
	GALAGO_VALUE_TYPE_USHORT,       /* Unsigned short integer.  */
	GALAGO_VALUE_TYPE_INT,          /* Integer.                 */
	GALAGO_VALUE_TYPE_UINT,         /* Unsigned integer.        */
	GALAGO_VALUE_TYPE_LONG,         /* Long integer.            */
	GALAGO_VALUE_TYPE_ULONG,        /* Unsigned long integer.   */
	GALAGO_VALUE_TYPE_STRING,       /* String.                  */
	GALAGO_VALUE_TYPE_OBJECT,       /* Object pointer.          */
	GALAGO_VALUE_TYPE_POINTER,      /* Generic pointer.         */
	GALAGO_VALUE_TYPE_LIST,         /* A list of values.        */
	GALAGO_VALUE_TYPE_ARRAY         /* An array of values.      */

} GalagoType;

GALAGO_VALUE_TYPE_UNKNOWN Unknown type.
GALAGO_VALUE_TYPE_CHAR Character.
GALAGO_VALUE_TYPE_UCHAR Unsigned character.
GALAGO_VALUE_TYPE_BOOLEAN Boolean
GALAGO_VALUE_TYPE_SHORT Short integer.
GALAGO_VALUE_TYPE_USHORT Unsigned short integer.
GALAGO_VALUE_TYPE_INT Integer.
GALAGO_VALUE_TYPE_UINT Unsigned integer.
GALAGO_VALUE_TYPE_LONG Long integer.
GALAGO_VALUE_TYPE_ULONG Unsigned long integer.
GALAGO_VALUE_TYPE_STRING String.
GALAGO_VALUE_TYPE_OBJECT Object pointer.
GALAGO_VALUE_TYPE_POINTER Generic pointer.
GALAGO_VALUE_TYPE_LIST A list of values.
GALAGO_VALUE_TYPE_ARRAY An array of values.

galago_value_new ()

GalagoValue*        galago_value_new                    (GalagoType type,
                                                         const void *data,
                                                         void *detail);

Creates a new GalagoValue.

type : The type.
data : The optional data to set.
detail : Extra detail, type-specific. Currently unused.
Returns : The new value.

galago_value_new_object ()

GalagoValue*        galago_value_new_object             (GType type,
                                                         const GObject *obj);

Creates a new, special GalagoValue that takes an object type and an optional object.

type : The GType.
obj : The object.
Returns : The new value.

galago_value_new_list ()

GalagoValue*        galago_value_new_list               (GalagoType type,
                                                         GList *list,
                                                         void *detail);

Creates a new, special GalagoValue that takes only a list of values of the specified type.

If type is GALAGO_VALUE_TYPE_OBJECT, detail must be the class type.

type : The type of list values.
list : The optional default list of values.
detail : Extra detail, type-specific.
Returns : The new value.

galago_value_new_array ()

GalagoValue*        galago_value_new_array              (GalagoType type,
                                                         const void *array,
                                                         gsize size,
                                                         void *detail);

Creates a new, special GalagoValue that takes only an array of values of the specified type.

If type is GALAGO_VALUE_TYPE_OBJECT, detail must be the class type.

type : The type of list values.
array : The optional default array of values.
size : The size of the array.
detail : Extra detail, type-specific.
Returns : The new value.

galago_value_destroy ()

void                galago_value_destroy                (GalagoValue *value);

Destroys a GalagoValue.

value : The GalagoValue.

galago_value_get_type ()

GalagoType          galago_value_get_type               (const GalagoValue *value);

Returns a GalagoValue's type.

value : The GalagoValue.
Returns : The GalagoValue's type.

galago_value_get_subtype ()

GalagoType          galago_value_get_subtype            (const GalagoValue *value);

Returns a value's subtype. This is only usable for lists and arrays.

value : The GalagoValue.
Returns : The value's list type.

galago_value_get_gtype ()

GType               galago_value_get_gtype              (const GalagoValue *value);

Returns the contained object's GType, if the GalagoValue's type is GALAGO_VALUE_TYPE_OBJECT.

value : The GalagoValue.
Returns : The object's GType, or NULL.

galago_value_set_char ()

void                galago_value_set_char               (GalagoValue *value,
                                                         char data);

Sets the value's character data.

value : The GalagoValue.
data : The character data.

galago_value_set_uchar ()

void                galago_value_set_uchar              (GalagoValue *value,
                                                         unsigned char data);

Sets the value's unsigned char data.

value : The GalagoValue.
data : The unsigned char data.

galago_value_set_boolean ()

void                galago_value_set_boolean            (GalagoValue *value,
                                                         gboolean data);

Sets the value's boolean data.

value : The GalagoValue.
data : The boolean data.

galago_value_set_short ()

void                galago_value_set_short              (GalagoValue *value,
                                                         short data );

Sets the value's short integer data.

value : The GalagoValue.
Param2 : The short integer data.

galago_value_set_ushort ()

void                galago_value_set_ushort             (GalagoValue *value,
                                                         short data );

Sets the value's unsigned short integer data.

value : The GalagoValue.
Param2 : The unsigned short integer data.

galago_value_set_int ()

void                galago_value_set_int                (GalagoValue *value,
                                                         int data);

Sets the value's integer data.

value : The GalagoValue.
data : The integer data.

galago_value_set_uint ()

void                galago_value_set_uint               (GalagoValue *value,
                                                         unsigned int data);

Sets the value's unsigned integer data.

value : The GalagoValue.
data : The unsigned integer data.

galago_value_set_long ()

void                galago_value_set_long               (GalagoValue *value,
                                                         long data );

Sets the value's long integer data.

value : The GalagoValue.
Param2 : The long integer data.

galago_value_set_ulong ()

void                galago_value_set_ulong              (GalagoValue *value,
                                                         long data );

Sets the value's unsigned long integer data.

value : The GalagoValue.
Param2 : The unsigned long integer data.

galago_value_set_string ()

void                galago_value_set_string             (GalagoValue *value,
                                                         const char *data);

Sets the value's string data.

value : The GalagoValue.
data : The string data.

galago_value_set_object ()

void                galago_value_set_object             (GalagoValue *value,
                                                         void *data);

Sets the value's object data.

value : The GalagoValue.
data : The object data.

galago_value_set_pointer ()

void                galago_value_set_pointer            (GalagoValue *value,
                                                         void *data);

Sets the value's pointer data.

value : The GalagoValue.
data : The pointer data.

galago_value_set_list ()

void                galago_value_set_list               (GalagoValue *value,
                                                         GList *data);

Sets the value's list of values.

value : The GalagoValue.
data : The list of values.

galago_value_set_array ()

void                galago_value_set_array              (GalagoValue *value,
                                                         const void *data,
                                                         gsize size);

Sets the value's array of values.

value : The GalagoValue.
data : The array of values.
size : The size of the array.

galago_value_get_char ()

char                galago_value_get_char               (const GalagoValue *value);

Returns the value's char data.

value : The GalagoValue.
Returns : The char data.

galago_value_get_uchar ()

unsigned char       galago_value_get_uchar              (const GalagoValue *value);

Returns the value's unsigned character data.

value : The GalagoValue.
Returns : The unsigned char data.

galago_value_get_boolean ()

gboolean            galago_value_get_boolean            (const GalagoValue *value);

Returns the value's boolean data.

value : The GalagoValue.
Returns : The boolean data.

galago_value_get_short ()

short               galago_value_get_short              (const GalagoValue *value);

Returns the value's short integer data.

value : The GalagoValue.
Returns : The short integer data.

galago_value_get_ushort ()

unsigned short      galago_value_get_ushort             (const GalagoValue *value);

Returns the value's unsigned short integer data.

value : The GalagoValue.
Returns : The unsigned short integer data.

galago_value_get_int ()

int                 galago_value_get_int                (const GalagoValue *value);

Returns the value's integer data.

value : The GalagoValue.
Returns : The integer data.

galago_value_get_uint ()

unsigned int        galago_value_get_uint               (const GalagoValue *value);

Returns the value's unsigned integer data.

value : The GalagoValue.
Returns : The unsigned integer data.

galago_value_get_long ()

long                galago_value_get_long               (const GalagoValue *value);

Returns the value's long integer data.

value : The GalagoValue.
Returns : The long integer data.

galago_value_get_ulong ()

unsigned long       galago_value_get_ulong              (const GalagoValue *value);

Returns the value's unsigned long integer data.

value : The GalagoValue.
Returns : The unsigned long integer data.

galago_value_get_string ()

const char*         galago_value_get_string             (const GalagoValue *value);

Returns the value's string data.

value : The GalagoValue.
Returns : The string data.

galago_value_get_object ()

void*               galago_value_get_object             (const GalagoValue *value);

Returns the value's object data.

value : The GalagoValue.
Returns : The object data.

galago_value_get_pointer ()

void*               galago_value_get_pointer            (const GalagoValue *value);

Returns the value's pointer data.

value : The GalagoValue.
Returns : The pointer data.

galago_value_get_list ()

GList*              galago_value_get_list               (const GalagoValue *value);

Returns the value's list of values.

value : The GalagoValue.
Returns : The list of values.

galago_value_get_array ()

void                galago_value_get_array              (const GalagoValue *value,
                                                         const void **ret_array,
                                                         gsize *ret_size);

Returns the value's array of values.

value : The GalagoValue.
ret_array : The returned array.
ret_size : The returned size of the array.