gda-field

gda-field — Management of database fields

Synopsis

struct              GdaFieldAttributes;
                    GdaField;
#define             GDA_TYPE_FIELD_ATTRIBUTES
GType               gda_field_attributes_get_type       (void);
GdaFieldAttributes * gda_field_attributes_new           (void);
GdaFieldAttributes * gda_field_attributes_copy          (GdaFieldAttributes *fa);
void                gda_field_attributes_free           (GdaFieldAttributes *fa);
gboolean            gda_field_attributes_equal          (const GdaFieldAttributes *lhs,
                                                         const GdaFieldAttributes *rhs);
glong               gda_field_attributes_get_defined_size
                                                        (GdaFieldAttributes *fa);
void                gda_field_attributes_set_defined_size
                                                        (GdaFieldAttributes *fa,
                                                         glong size);
const gchar *       gda_field_attributes_get_name       (GdaFieldAttributes *fa);
void                gda_field_attributes_set_name       (GdaFieldAttributes *fa,
                                                         const gchar *name);
const gchar *       gda_field_attributes_get_table      (GdaFieldAttributes *fa);
void                gda_field_attributes_set_table      (GdaFieldAttributes *fa,
                                                         const gchar *table);
const gchar *       gda_field_attributes_get_caption    (GdaFieldAttributes *fa);
void                gda_field_attributes_set_caption    (GdaFieldAttributes *fa,
                                                         const gchar *caption);
glong               gda_field_attributes_get_scale      (GdaFieldAttributes *fa);
void                gda_field_attributes_set_scale      (GdaFieldAttributes *fa,
                                                         glong scale);
GdaValueType        gda_field_attributes_get_gdatype    (GdaFieldAttributes *fa);
void                gda_field_attributes_set_gdatype    (GdaFieldAttributes *fa,
                                                         GdaValueType type);
gboolean            gda_field_attributes_get_allow_null (GdaFieldAttributes *fa);
void                gda_field_attributes_set_allow_null (GdaFieldAttributes *fa,
                                                         gboolean allow);
gboolean            gda_field_attributes_get_primary_key
                                                        (GdaFieldAttributes *fa);
void                gda_field_attributes_set_primary_key
                                                        (GdaFieldAttributes *fa,
                                                         gboolean pk);
gboolean            gda_field_attributes_get_unique_key (GdaFieldAttributes *fa);
void                gda_field_attributes_set_unique_key (GdaFieldAttributes *fa,
                                                         gboolean uk);
const gchar *       gda_field_attributes_get_references (GdaFieldAttributes *fa);
void                gda_field_attributes_set_references (GdaFieldAttributes *fa,
                                                         const gchar *ref);
gboolean            gda_field_attributes_get_auto_increment
                                                        (GdaFieldAttributes *fa);
void                gda_field_attributes_set_auto_increment
                                                        (GdaFieldAttributes *fa,
                                                         gboolean is_auto);
gint                gda_field_attributes_get_position   (GdaFieldAttributes *fa);
void                gda_field_attributes_set_position   (GdaFieldAttributes *fa,
                                                         gint position);
const GdaValue *    gda_field_attributes_get_default_value
                                                        (GdaFieldAttributes *fa);
void                gda_field_attributes_set_default_value
                                                        (GdaFieldAttributes *fa,
                                                         const GdaValue *default_value);

Description

Details

struct GdaFieldAttributes

struct GdaFieldAttributes {
	gint defined_size;
	gchar *name;
	gchar *table;
	gchar *caption;
	gint scale;
	GdaValueType gda_type;
	gboolean allow_null;
	gboolean primary_key;
	gboolean unique_key;
	gchar *references;
	gboolean auto_increment;
	glong auto_increment_start;
	glong auto_increment_step;
	gint position;
	GdaValue *default_value;
};

GdaField

typedef struct {
	gint actual_size;
	GdaValue *value;
	GdaFieldAttributes *attributes;
} GdaField;

GDA_TYPE_FIELD_ATTRIBUTES

#define GDA_TYPE_FIELD_ATTRIBUTES (gda_field_attributes_get_type ())

gda_field_attributes_get_type ()

GType               gda_field_attributes_get_type       (void);

gda_field_attributes_new ()

GdaFieldAttributes * gda_field_attributes_new           (void);

Returns :

 a newly allocated GdaFieldAttributes object.

gda_field_attributes_copy ()

GdaFieldAttributes * gda_field_attributes_copy          (GdaFieldAttributes *fa);

Creates a new GdaFieldAttributes object from an existing one.

fa :

 attributes to get a copy from.

Returns :

 a newly allocated GdaFieldAttributes with a copy of the data in fa.

gda_field_attributes_free ()

void                gda_field_attributes_free           (GdaFieldAttributes *fa);

Deallocates all memory associated to the given GdaFieldAttributes object.

fa :

 the resource to free.

gda_field_attributes_equal ()

gboolean            gda_field_attributes_equal          (const GdaFieldAttributes *lhs,
                                                         const GdaFieldAttributes *rhs);

Tests whether two field attributes are equal.

lhs :

 a GdaFieldAttributes

rhs :

 another GdaFieldAttributes

Returns :

 TRUE if the field attributes contain the same information.

gda_field_attributes_get_defined_size ()

glong               gda_field_attributes_get_defined_size
                                                        (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 the defined size of fa.

gda_field_attributes_set_defined_size ()

void                gda_field_attributes_set_defined_size
                                                        (GdaFieldAttributes *fa,
                                                         glong size);

Sets the defined size of a GdaFieldAttributes.

fa :

 a GdaFieldAttributes.

size :

 the defined size we want to set.

gda_field_attributes_get_name ()

const gchar *       gda_field_attributes_get_name       (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 the name of fa.

gda_field_attributes_set_name ()

void                gda_field_attributes_set_name       (GdaFieldAttributes *fa,
                                                         const gchar *name);

Sets the name of fa to name.

fa :

 a GdaFieldAttributes.

name :

 the new name of fa.

gda_field_attributes_get_table ()

const gchar *       gda_field_attributes_get_table      (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 the name of the table to which this field belongs.

gda_field_attributes_set_table ()

void                gda_field_attributes_set_table      (GdaFieldAttributes *fa,
                                                         const gchar *table);

Sets the name of the table to which the given field belongs.

fa :

 a GdaFieldAttributes.

table :

 table name.

gda_field_attributes_get_caption ()

const gchar *       gda_field_attributes_get_caption    (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 fa's caption.

gda_field_attributes_set_caption ()

void                gda_field_attributes_set_caption    (GdaFieldAttributes *fa,
                                                         const gchar *caption);

Sets fa's caption.

fa :

 a GdaFieldAttributes.

caption :

 caption.

gda_field_attributes_get_scale ()

glong               gda_field_attributes_get_scale      (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 the number of decimals of fa.

gda_field_attributes_set_scale ()

void                gda_field_attributes_set_scale      (GdaFieldAttributes *fa,
                                                         glong scale);

Sets the scale of fa to scale.

fa :

 a GdaFieldAttributes.

scale :

 number of decimals.

gda_field_attributes_get_gdatype ()

GdaValueType        gda_field_attributes_get_gdatype    (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 the type of fa.

gda_field_attributes_set_gdatype ()

void                gda_field_attributes_set_gdatype    (GdaFieldAttributes *fa,
                                                         GdaValueType type);

Sets the type of fa to type.

fa :

 a GdaFieldAttributes.

type :

 the new type of fa.

gda_field_attributes_get_allow_null ()

gboolean            gda_field_attributes_get_allow_null (GdaFieldAttributes *fa);

Gets the 'allow null' flag of the given field attributes.

fa :

 a GdaFieldAttributes.

Returns :

 whether the given field allows null values or not (TRUE or FALSE).

gda_field_attributes_set_allow_null ()

void                gda_field_attributes_set_allow_null (GdaFieldAttributes *fa,
                                                         gboolean allow);

Sets the 'allow null' flag of the given field attributes.

fa :

 a GdaFieldAttributes.

allow :

 whether the given field should allows null values or not.

gda_field_attributes_get_primary_key ()

gboolean            gda_field_attributes_get_primary_key
                                                        (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 whether if the given field is a primary key (TRUE or FALSE).

gda_field_attributes_set_primary_key ()

void                gda_field_attributes_set_primary_key
                                                        (GdaFieldAttributes *fa,
                                                         gboolean pk);

Sets the 'primary key' flag of the given field attributes.

fa :

 a GdaFieldAttributes.

pk :

 whether if the given field should be a primary key.

gda_field_attributes_get_unique_key ()

gboolean            gda_field_attributes_get_unique_key (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 whether if the given field is an unique key (TRUE or FALSE).

gda_field_attributes_set_unique_key ()

void                gda_field_attributes_set_unique_key (GdaFieldAttributes *fa,
                                                         gboolean uk);

Sets the 'unique key' flag of the given field attributes.

fa :

 a GdaFieldAttributes.

uk :

 whether if the given field should be an unique key.

gda_field_attributes_get_references ()

const gchar *       gda_field_attributes_get_references (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 fa's references.

gda_field_attributes_set_references ()

void                gda_field_attributes_set_references (GdaFieldAttributes *fa,
                                                         const gchar *ref);

Sets fa's references.

fa :

 a GdaFieldAttributes.

ref :

 references.

gda_field_attributes_get_auto_increment ()

gboolean            gda_field_attributes_get_auto_increment
                                                        (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 whether the given field is an auto incremented one (TRUE or FALSE).

gda_field_attributes_set_auto_increment ()

void                gda_field_attributes_set_auto_increment
                                                        (GdaFieldAttributes *fa,
                                                         gboolean is_auto);

Sets the auto increment flag for the given field.

fa :

 a GdaFieldAttributes.

is_auto :

 auto increment status.

gda_field_attributes_get_position ()

gint                gda_field_attributes_get_position   (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 the position of the field the attributes refer to in the containing data model.

gda_field_attributes_set_position ()

void                gda_field_attributes_set_position   (GdaFieldAttributes *fa,
                                                         gint position);

Sets the position of the field the attributes refer to in the containing data model.

fa :

 a GdaFieldAttributes.

position :

 the wanted position of the field in the containing data model.

gda_field_attributes_get_default_value ()

const GdaValue *    gda_field_attributes_get_default_value
                                                        (GdaFieldAttributes *fa);

fa :

 a GdaFieldAttributes.

Returns :

 fa's default value, as a GdaValue object.

gda_field_attributes_set_default_value ()

void                gda_field_attributes_set_default_value
                                                        (GdaFieldAttributes *fa,
                                                         const GdaValue *default_value);

Sets fa's default GdaValue.

fa :

 a GdaFieldAttributes.

default_value :

 default GdaValue for the field
Generated by GTK-Doc V1.18