gda-value

gda-value — Data values

Synopsis




#define     TIMEZONE_INVALID
enum        GdaValueType;
struct      GdaDate;
struct      GdaGeometricPoint;
struct      GdaMoney;
struct      GdaNumeric;
struct      GdaTime;
struct      GdaTimestamp;
typedef     GdaValueList;
struct      GdaValue;
#define     GDA_TYPE_VALUE
GType       gda_value_get_gtype             (void);
GdaValue*   gda_value_new_null              (void);
GdaValue*   gda_value_new_bigint            (gint64 val);
GdaValue*   gda_value_new_biguint           (guint64 val);
GdaValue*   gda_value_new_binary            (gconstpointer val,
                                             glong size);
GdaValue*   gda_value_new_blob              (const GdaBlob *val);
GdaValue*   gda_value_new_boolean           (gboolean val);
GdaValue*   gda_value_new_date              (const GdaDate *val);
GdaValue*   gda_value_new_double            (gdouble val);
GdaValue*   gda_value_new_geometric_point   (const GdaGeometricPoint *val);
GdaValue*   gda_value_new_gobject           (const GObject *val);
GdaValue*   gda_value_new_integer           (gint val);
GdaValue*   gda_value_new_list              (const GdaValueList *val);
GdaValue*   gda_value_new_money             (const GdaMoney *val);
GdaValue*   gda_value_new_numeric           (const GdaNumeric *val);
GdaValue*   gda_value_new_single            (gfloat val);
GdaValue*   gda_value_new_smallint          (gshort val);
GdaValue*   gda_value_new_smalluint         (gushort val);
GdaValue*   gda_value_new_string            (const gchar *val);
GdaValue*   gda_value_new_time              (const GdaTime *val);
GdaValue*   gda_value_new_timestamp         (const GdaTimestamp *val);
GdaValue*   gda_value_new_timestamp_from_timet
                                            (time_t val);
GdaValue*   gda_value_new_tinyint           (gchar val);
GdaValue*   gda_value_new_tinyuint          (guchar val);
GdaValue*   gda_value_new_type              (GdaValueType val);
GdaValue*   gda_value_new_uinteger          (guint val);
GdaValue*   gda_value_new_from_string       (const gchar *as_string,
                                             GdaValueType type);
GdaValue*   gda_value_new_from_xml          (const xmlNodePtr node);
void        gda_value_free                  (GdaValue *value);
GdaValueType gda_value_get_type             (GdaValue *value);
#define     gda_value_isa                   (value,type)
gboolean    gda_value_is_null               (GdaValue *value);
gboolean    gda_value_is_number             (GdaValue *value);
GdaValue*   gda_value_copy                  (GdaValue *value);
gint64      gda_value_get_bigint            (GdaValue *value);
void        gda_value_set_bigint            (GdaValue *value,
                                             gint64 val);
guint64     gda_value_get_biguint           (GdaValue *value);
void        gda_value_set_biguint           (GdaValue *value,
                                             guint64 val);
G_CONST_RETURN gpointer gda_value_get_binary
                                            (GdaValue *value,
                                             glong *size);
void        gda_value_set_binary            (GdaValue *value,
                                             gconstpointer val,
                                             glong size);
G_CONST_RETURN GdaBlob* gda_value_get_blob  (GdaValue *value);
void        gda_value_set_blob              (GdaValue *value,
                                             const GdaBlob *val);
gboolean    gda_value_get_boolean           (GdaValue *value);
void        gda_value_set_boolean           (GdaValue *value,
                                             gboolean val);
G_CONST_RETURN GdaDate* gda_value_get_date  (GdaValue *value);
void        gda_value_set_date              (GdaValue *value,
                                             const GdaDate *val);
gdouble     gda_value_get_double            (GdaValue *value);
void        gda_value_set_double            (GdaValue *value,
                                             gdouble val);
G_CONST_RETURN GdaGeometricPoint* gda_value_get_geometric_point
                                            (GdaValue *value);
void        gda_value_set_geometric_point   (GdaValue *value,
                                             const GdaGeometricPoint *val);
G_CONST_RETURN GObject* gda_value_get_gobject
                                            (GdaValue *value);
void        gda_value_set_gobject           (GdaValue *value,
                                             const GObject *val);
gint        gda_value_get_integer           (GdaValue *value);
void        gda_value_set_integer           (GdaValue *value,
                                             gint val);
G_CONST_RETURN GdaValueList* gda_value_get_list
                                            (GdaValue *value);
void        gda_value_set_list              (GdaValue *value,
                                             const GdaValueList *val);
void        gda_value_set_null              (GdaValue *value);
G_CONST_RETURN GdaMoney* gda_value_get_money
                                            (GdaValue *value);
void        gda_value_set_money             (GdaValue *value,
                                             const GdaMoney *val);
G_CONST_RETURN GdaNumeric* gda_value_get_numeric
                                            (GdaValue *value);
void        gda_value_set_numeric           (GdaValue *value,
                                             const GdaNumeric *val);
gfloat      gda_value_get_single            (GdaValue *value);
void        gda_value_set_single            (GdaValue *value,
                                             gfloat val);
gshort      gda_value_get_smallint          (GdaValue *value);
void        gda_value_set_smallint          (GdaValue *value,
                                             gshort val);
gushort     gda_value_get_smalluint         (GdaValue *value);
void        gda_value_set_smalluint         (GdaValue *value,
                                             gushort val);
G_CONST_RETURN gchar* gda_value_get_string  (GdaValue *value);
void        gda_value_set_string            (GdaValue *value,
                                             const gchar *val);
G_CONST_RETURN GdaTime* gda_value_get_time  (GdaValue *value);
void        gda_value_set_time              (GdaValue *value,
                                             const GdaTime *val);
G_CONST_RETURN GdaTimestamp* gda_value_get_timestamp
                                            (GdaValue *value);
void        gda_value_set_timestamp         (GdaValue *value,
                                             const GdaTimestamp *val);
gchar       gda_value_get_tinyint           (GdaValue *value);
void        gda_value_set_tinyint           (GdaValue *value,
                                             gchar val);
guchar      gda_value_get_tinyuint          (GdaValue *value);
void        gda_value_set_tinyuint          (GdaValue *value,
                                             guchar val);
guint       gda_value_get_uinteger          (GdaValue *value);
void        gda_value_set_uinteger          (GdaValue *value,
                                             guint val);
GdaValueType gda_value_get_vtype            (GdaValue *value);
void        gda_value_set_vtype             (GdaValue *value,
                                             GdaValueType type);
gboolean    gda_value_set_from_string       (GdaValue *value,
                                             const gchar *as_string,
                                             GdaValueType type);
gboolean    gda_value_set_from_value        (GdaValue *value,
                                             const GdaValue *from);
gint        gda_value_compare               (GdaValue *value1,
                                             GdaValue *value2);
gchar*      gda_value_stringify             (GdaValue *value);
xmlNodePtr  gda_value_to_xml                (GdaValue *value);

Description

Details

TIMEZONE_INVALID

#define TIMEZONE_INVALID (2*12*60*60)


enum GdaValueType

typedef enum {
	GDA_VALUE_TYPE_NULL,
	GDA_VALUE_TYPE_BIGINT,
	GDA_VALUE_TYPE_BIGUINT,
	GDA_VALUE_TYPE_BINARY,
	GDA_VALUE_TYPE_BLOB,
	GDA_VALUE_TYPE_BOOLEAN,
	GDA_VALUE_TYPE_DATE,
	GDA_VALUE_TYPE_DOUBLE,
	GDA_VALUE_TYPE_GEOMETRIC_POINT,
	GDA_VALUE_TYPE_GOBJECT,
	GDA_VALUE_TYPE_INTEGER,
	GDA_VALUE_TYPE_LIST,
	GDA_VALUE_TYPE_MONEY,
	GDA_VALUE_TYPE_NUMERIC,
	GDA_VALUE_TYPE_SINGLE,
	GDA_VALUE_TYPE_SMALLINT,
	GDA_VALUE_TYPE_SMALLUINT,
	GDA_VALUE_TYPE_STRING,
	GDA_VALUE_TYPE_TIME,
	GDA_VALUE_TYPE_TIMESTAMP,
	GDA_VALUE_TYPE_TINYINT,
	GDA_VALUE_TYPE_TINYUINT,
	GDA_VALUE_TYPE_TYPE,
        GDA_VALUE_TYPE_UINTEGER,
	GDA_VALUE_TYPE_UNKNOWN
} GdaValueType;


struct GdaDate

struct GdaDate {

	gshort year;
	gushort month;
	gushort day;
};


struct GdaGeometricPoint

struct GdaGeometricPoint {

	gdouble x;
	gdouble y;
};


struct GdaMoney

struct GdaMoney {

	gchar *currency;
	gdouble amount;
};


struct GdaNumeric

struct GdaNumeric {

	gchar *number;
	glong precision;
	glong width;
};


struct GdaTime

struct GdaTime {

	gushort hour;
	gushort minute;
	gushort second;
	glong timezone;	/* # of seconds to the east UTC */
};


struct GdaTimestamp

struct GdaTimestamp {

	gshort year;
	gushort month;
	gushort day;
	gushort hour;
	gushort minute;
	gushort second;
	gulong fraction;
	glong timezone;	/* # of seconds to the east UTC */
};


GdaValueList

typedef GList GdaValueList;


struct GdaValue

struct GdaValue {

	GdaValueType type;
	union {
		gint64 v_bigint;
 	        guint64 v_biguint;
		gpointer v_binary;
		GdaBlob v_blob;
		gboolean v_boolean;
		GdaDate v_date;
		gdouble v_double;
		GdaGeometricPoint v_point;
		GObject *v_gobj;
		gint v_integer;
		GdaValueList *v_list;
		GdaMoney v_money;
		GdaNumeric v_numeric;
		gfloat v_single;
		gshort v_smallint;
 	        gushort v_smalluint;
		gchar *v_string;
		GdaTime v_time;
		GdaTimestamp v_timestamp;
		gchar v_tinyint;
 	        guchar v_tinyuint;
		GdaValueType v_type;
		guint v_uinteger;
	} value;
	glong binary_length;
};


GDA_TYPE_VALUE

#define GDA_TYPE_VALUE (gda_value_get_gtype())


gda_value_get_gtype ()

GType       gda_value_get_gtype             (void);

Returns :

gda_value_new_null ()

GdaValue*   gda_value_new_null              (void);

Makes a new GdaValue of type GDA_VALUE_TYPE_NULL.

Returns : the newly created GdaValue.

gda_value_new_bigint ()

GdaValue*   gda_value_new_bigint            (gint64 val);

Makes a new GdaValue of type GDA_VALUE_TYPE_BIGINT with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_biguint ()

GdaValue*   gda_value_new_biguint           (guint64 val);

Makes a new GdaValue of type GDA_VALUE_TYPE_BIGUINT with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_binary ()

GdaValue*   gda_value_new_binary            (gconstpointer val,
                                             glong size);

Makes a new GdaValue of type GDA_VALUE_TYPE_BINARY with value val.

val : value to set for the new GdaValue.
size : the size of the memory pool pointer to by val.
Returns : the newly created GdaValue.

gda_value_new_blob ()

GdaValue*   gda_value_new_blob              (const GdaBlob *val);

val :
Returns :

gda_value_new_boolean ()

GdaValue*   gda_value_new_boolean           (gboolean val);

Makes a new GdaValue of type GDA_VALUE_TYPE_BOOLEAN with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_date ()

GdaValue*   gda_value_new_date              (const GdaDate *val);

Makes a new GdaValue of type GDA_VALUE_TYPE_DATE with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_double ()

GdaValue*   gda_value_new_double            (gdouble val);

Makes a new GdaValue of type GDA_VALUE_TYPE_DOUBLE with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_geometric_point ()

GdaValue*   gda_value_new_geometric_point   (const GdaGeometricPoint *val);

Makes a new GdaValue of type GDA_VALUE_TYPE_GEOMETRIC_POINT with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_gobject ()

GdaValue*   gda_value_new_gobject           (const GObject *val);

Makes a new GdaValue of type GDA_VALUE_TYPE_GOBJECT with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_integer ()

GdaValue*   gda_value_new_integer           (gint val);

Makes a new GdaValue of type GDA_VALUE_TYPE_INTEGER with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_list ()

GdaValue*   gda_value_new_list              (const GdaValueList *val);

Makes a new GdaValue of type GDA_VALUE_TYPE_LIST with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_money ()

GdaValue*   gda_value_new_money             (const GdaMoney *val);

val :
Returns :

gda_value_new_numeric ()

GdaValue*   gda_value_new_numeric           (const GdaNumeric *val);

Makes a new GdaValue of type GDA_VALUE_TYPE_NUMERIC with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_single ()

GdaValue*   gda_value_new_single            (gfloat val);

Makes a new GdaValue of type GDA_VALUE_TYPE_SINGLE with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_smallint ()

GdaValue*   gda_value_new_smallint          (gshort val);

Makes a new GdaValue of type GDA_VALUE_TYPE_SMALLINT with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_smalluint ()

GdaValue*   gda_value_new_smalluint         (gushort val);

Makes a new GdaValue of type GDA_VALUE_TYPE_SMALLUINT with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_string ()

GdaValue*   gda_value_new_string            (const gchar *val);

Makes a new GdaValue of type GDA_VALUE_TYPE_STRING with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_time ()

GdaValue*   gda_value_new_time              (const GdaTime *val);

Makes a new GdaValue of type GDA_VALUE_TYPE_TIME with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_timestamp ()

GdaValue*   gda_value_new_timestamp         (const GdaTimestamp *val);

Makes a new GdaValue of type GDA_VALUE_TYPE_TIMESTAMP with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_timestamp_from_timet ()

GdaValue*   gda_value_new_timestamp_from_timet
                                            (time_t val);

Makes a new GdaValue of type GDA_VALUE_TYPE_TIMESTAMP with value val (of type time_t).

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_tinyint ()

GdaValue*   gda_value_new_tinyint           (gchar val);

Makes a new GdaValue of type GDA_VALUE_TYPE_TINYINT with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_tinyuint ()

GdaValue*   gda_value_new_tinyuint          (guchar val);

Makes a new GdaValue of type GDA_VALUE_TYPE_TINYUINT with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_type ()

GdaValue*   gda_value_new_type              (GdaValueType val);

Makes a new GdaValue of type GDA_VALUE_TYPE_TYPE with value val.

val : Value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_uinteger ()

GdaValue*   gda_value_new_uinteger          (guint val);

Makes a new GdaValue of type GDA_VALUE_TYPE_UINTEGER with value val.

val : value to set for the new GdaValue.
Returns : the newly created GdaValue.

gda_value_new_from_string ()

GdaValue*   gda_value_new_from_string       (const gchar *as_string,
                                             GdaValueType type);

Makes a new GdaValue of type type from its string representation.

as_string : stringified representation of the value.
type : the new value type.
Returns : the newly created GdaValue or NULL if the string representation cannot be converted to the specified type.

gda_value_new_from_xml ()

GdaValue*   gda_value_new_from_xml          (const xmlNodePtr node);

Creates a GdaValue from a XML representation of it. That XML node corresponds to the following string representation: <value type="gdatype">value</value>

node : a XML node representing the value.
Returns : the newly created GdaValue.

gda_value_free ()

void        gda_value_free                  (GdaValue *value);

Deallocates all memory associated to a GdaValue.

value : the resource to free.

gda_value_get_type ()

GdaValueType gda_value_get_type             (GdaValue *value);

Retrieves the type of the given value.

value : value to get the type from.
Returns : the GdaValueType of the value.

gda_value_isa()

#define       gda_value_isa(value,type) (gda_value_get_type (value) == type)

value :
type :

gda_value_is_null ()

gboolean    gda_value_is_null               (GdaValue *value);

Tests if a given value is of type GDA_VALUE_TYPE_NULL.

value : value to test.
Returns : a boolean that says whether or not value is of type GDA_VALUE_TYPE_NULL.

gda_value_is_number ()

gboolean    gda_value_is_number             (GdaValue *value);

Gets whether the value stored in the given GdaValue is of numeric type or not.

value : a GdaValue.
Returns : TRUE if a number, FALSE otherwise.

gda_value_copy ()

GdaValue*   gda_value_copy                  (GdaValue *value);

Creates a new GdaValue from an existing one.

value : value to get a copy from.
Returns : a newly allocated GdaValue with a copy of the data in value.

gda_value_get_bigint ()

gint64      gda_value_get_bigint            (GdaValue *value);

Gets the value stored in value.

value : a GdaValue whose value we want to get.
Returns : the value contained in value.

gda_value_set_bigint ()

void        gda_value_set_bigint            (GdaValue *value,
                                             gint64 val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_biguint ()

guint64     gda_value_get_biguint           (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_biguint ()

void        gda_value_set_biguint           (GdaValue *value,
                                             guint64 val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_binary ()

G_CONST_RETURN gpointer gda_value_get_binary
                                            (GdaValue *value,
                                             glong *size);

value : a GdaValue whose value we want to get.
size : holder for length of data.
Returns : the value stored in value.

gda_value_set_binary ()

void        gda_value_set_binary            (GdaValue *value,
                                             gconstpointer val,
                                             glong size);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.
size : the size of the memory pool pointed to by val.

gda_value_get_blob ()

G_CONST_RETURN GdaBlob* gda_value_get_blob  (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_blob ()

void        gda_value_set_blob              (GdaValue *value,
                                             const GdaBlob *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_boolean ()

gboolean    gda_value_get_boolean           (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_boolean ()

void        gda_value_set_boolean           (GdaValue *value,
                                             gboolean val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_date ()

G_CONST_RETURN GdaDate* gda_value_get_date  (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_date ()

void        gda_value_set_date              (GdaValue *value,
                                             const GdaDate *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_double ()

gdouble     gda_value_get_double            (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_double ()

void        gda_value_set_double            (GdaValue *value,
                                             gdouble val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_geometric_point ()

G_CONST_RETURN GdaGeometricPoint* gda_value_get_geometric_point
                                            (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_geometric_point ()

void        gda_value_set_geometric_point   (GdaValue *value,
                                             const GdaGeometricPoint *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_gobject ()

G_CONST_RETURN GObject* gda_value_get_gobject
                                            (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_gobject ()

void        gda_value_set_gobject           (GdaValue *value,
                                             const GObject *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_integer ()

gint        gda_value_get_integer           (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_integer ()

void        gda_value_set_integer           (GdaValue *value,
                                             gint val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_list ()

G_CONST_RETURN GdaValueList* gda_value_get_list
                                            (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_list ()

void        gda_value_set_list              (GdaValue *value,
                                             const GdaValueList *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_set_null ()

void        gda_value_set_null              (GdaValue *value);

Sets the type of value to GDA_VALUE_TYPE_NULL.

value : a GdaValue that will store a value of type GDA_VALUE_TYPE_NULL.

gda_value_get_money ()

G_CONST_RETURN GdaMoney* gda_value_get_money
                                            (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_money ()

void        gda_value_set_money             (GdaValue *value,
                                             const GdaMoney *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_numeric ()

G_CONST_RETURN GdaNumeric* gda_value_get_numeric
                                            (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_numeric ()

void        gda_value_set_numeric           (GdaValue *value,
                                             const GdaNumeric *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_single ()

gfloat      gda_value_get_single            (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_single ()

void        gda_value_set_single            (GdaValue *value,
                                             gfloat val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_smallint ()

gshort      gda_value_get_smallint          (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_smallint ()

void        gda_value_set_smallint          (GdaValue *value,
                                             gshort val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_smalluint ()

gushort     gda_value_get_smalluint         (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_smalluint ()

void        gda_value_set_smalluint         (GdaValue *value,
                                             gushort val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_string ()

G_CONST_RETURN gchar* gda_value_get_string  (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_string ()

void        gda_value_set_string            (GdaValue *value,
                                             const gchar *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_time ()

G_CONST_RETURN GdaTime* gda_value_get_time  (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_time ()

void        gda_value_set_time              (GdaValue *value,
                                             const GdaTime *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_timestamp ()

G_CONST_RETURN GdaTimestamp* gda_value_get_timestamp
                                            (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_timestamp ()

void        gda_value_set_timestamp         (GdaValue *value,
                                             const GdaTimestamp *val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_tinyint ()

gchar       gda_value_get_tinyint           (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_tinyint ()

void        gda_value_set_tinyint           (GdaValue *value,
                                             gchar val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_tinyuint ()

guchar      gda_value_get_tinyuint          (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_tinyuint ()

void        gda_value_set_tinyuint          (GdaValue *value,
                                             guchar val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_uinteger ()

guint       gda_value_get_uinteger          (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_uinteger ()

void        gda_value_set_uinteger          (GdaValue *value,
                                             guint val);

Stores val into value.

value : a GdaValue that will store val.
val : value to be stored in value.

gda_value_get_vtype ()

GdaValueType gda_value_get_vtype            (GdaValue *value);

value : a GdaValue whose value we want to get.
Returns : the value stored in value.

gda_value_set_vtype ()

void        gda_value_set_vtype             (GdaValue *value,
                                             GdaValueType type);

Stores type into value.

value : a GdaValue that will store type.
type : value to be stored in value.

gda_value_set_from_string ()

gboolean    gda_value_set_from_string       (GdaValue *value,
                                             const gchar *as_string,
                                             GdaValueType type);

Stores the value data from its string representation as type.

value : a GdaValue that will store val.
as_string : the stringified representation of the value.
type : the type of the value
Returns : TRUE if the value has been properly converted to type from its string representation. FALSE otherwise.

gda_value_set_from_value ()

gboolean    gda_value_set_from_value        (GdaValue *value,
                                             const GdaValue *from);

Sets the value of a GdaValue from another GdaValue. This is different from gda_value_copy, which creates a new GdaValue. gda_value_set_from_value, on the other hand, copies the contents of copy into value, which must already be allocated.

value : a GdaValue.
from : the value to copy from.
Returns : TRUE if successful, FALSE otherwise.

gda_value_compare ()

gint        gda_value_compare               (GdaValue *value1,
                                             GdaValue *value2);

Compares two values of the same type.

value1 : a GdaValue to compare.
value2 : the other GdaValue to be compared to value1.
Returns : if both values have the same type, returns 0 if both contain the same value, an integer less than 0 if value1 is less than value2 or an integer greater than 0 if value1 is greater than value2.

gda_value_stringify ()

gchar*      gda_value_stringify             (GdaValue *value);

Converts a GdaValue to its string representation as indicated by this table:

value : a GdaValue.
Returns : a string formatted according to the printf() style indicated in the preceding table. Free the value with a g_free() when you've finished using it.

gda_value_to_xml ()

xmlNodePtr  gda_value_to_xml                (GdaValue *value);

Serializes the given GdaValue to a XML node string.

value : a GdaValue.
Returns : the XML node. Once not needed anymore, you should free it.