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 Param2);
void                galago_value_set_ushort             (GalagoValue *value,
                                                         unsigned 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 Param2);
void                galago_value_set_ulong              (GalagoValue *value,
                                                         unsigned 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 Param2);

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,
                                                         unsigned short  data);

Sets the value's unsigned short integer data.

value :

The GalagoValue.

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 Param2);

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,
                                                         unsigned long  data);

Sets the value's unsigned long integer data.

value :

The GalagoValue.

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.