![]() |
![]() |
![]() |
Libgnomedb Reference Manual | ![]() |
---|---|---|---|---|
GnomeDbTableField; GObject* gnome_db_table_field_new (GnomeDbDict *dict, GnomeDbServerDataType *type); void gnome_db_table_field_set_length (GnomeDbTableField *field, gint length); gint gnome_db_table_field_get_length (GnomeDbTableField *field); void gnome_db_table_field_set_scale (GnomeDbTableField *field, gint length); gint gnome_db_table_field_get_scale (GnomeDbTableField *field); GSList* gnome_db_table_field_get_constraints (GnomeDbTableField *field); void gnome_db_table_field_set_data_type (GnomeDbTableField *field, GnomeDbServerDataType *type); void gnome_db_table_field_set_default_value (GnomeDbTableField *field, const GdaValue *value); const GdaValue* gnome_db_table_field_get_default_value (GnomeDbTableField *field); gboolean gnome_db_table_field_is_null_allowed (GnomeDbTableField *field); gboolean gnome_db_table_field_is_pkey_part (GnomeDbTableField *field); gboolean gnome_db_table_field_is_pkey_alone (GnomeDbTableField *field); gboolean gnome_db_table_field_is_fkey_part (GnomeDbTableField *field); gboolean gnome_db_table_field_is_fkey_alone (GnomeDbTableField *field); void gnome_db_table_field_set_attributes (GnomeDbTableField *field, guint attributes); guint gnome_db_table_field_get_attributes (GnomeDbTableField *field);
GnomeDbTableField implements GnomeDbXmlStorage, GnomeDbRenderer and GnomeDbField.
It implements the following interfaces: GnomeDbField, GnomeDbXmlStorage and GnomeDbRenderer.
GObject* gnome_db_table_field_new (GnomeDbDict *dict, GnomeDbServerDataType *type);
Creates a new GnomeDbTableField object
dict : |
a GnomeDbDict object |
type : |
a GnomeDbServerDataType object (the field's type) |
Returns : | the new object |
void gnome_db_table_field_set_length (GnomeDbTableField *field, gint length);
field : |
|
length : |
gint gnome_db_table_field_get_length (GnomeDbTableField *field);
Get the length of a field.
field : |
a GnomeDbTableField object |
Returns : | the size of the corresponding data type has a fixed size, or -1 |
void gnome_db_table_field_set_scale (GnomeDbTableField *field, gint length);
field : |
|
length : |
gint gnome_db_table_field_get_scale (GnomeDbTableField *field);
Get the scale of a field.
field : |
a GnomeDbTableField object |
Returns : | the size of the corresponding data type has a fixed size, or -1 |
GSList* gnome_db_table_field_get_constraints (GnomeDbTableField *field);
Get all the constraints which impact the given field. Constraints are of several type: NOT NULL, primary key, foreign key, check constrains
field : |
a GnomeDbTableField object |
Returns : | a new list of GnomeDbConstraint objects |
void gnome_db_table_field_set_data_type (GnomeDbTableField *field, GnomeDbServerDataType *type);
Sets the data type of the field
field : |
a GnomeDbTableField object |
type : |
a GnomeDbServerDataType object |
void gnome_db_table_field_set_default_value (GnomeDbTableField *field, const GdaValue *value);
Sets (or replace) the default value for the field. WARNING: the default value's data type can be different from the field's data type (this is the case for example if the default value is a function like Postgres's default value for the SERIAL data type).
field : |
a GnomeDbTableField object |
value : |
a GdaValue value or NULL |
const GdaValue* gnome_db_table_field_get_default_value (GnomeDbTableField *field);
Get the default value for the field if ne exists
field : |
a GnomeDbTableField object |
Returns : | the default value |
gboolean gnome_db_table_field_is_null_allowed (GnomeDbTableField *field);
Test if field
can be NULL
or not
field : |
a GnomeDbTableField object |
Returns : |
gboolean gnome_db_table_field_is_pkey_part (GnomeDbTableField *field);
Test if field
is part of a primary key constraint
field : |
a GnomeDbTableField object |
Returns : |
gboolean gnome_db_table_field_is_pkey_alone (GnomeDbTableField *field);
Test if field
is alone a primary key constraint
field : |
a GnomeDbTableField object |
Returns : |
gboolean gnome_db_table_field_is_fkey_part (GnomeDbTableField *field);
Test if field
is part of a foreign key constraint
field : |
a GnomeDbTableField object |
Returns : |
gboolean gnome_db_table_field_is_fkey_alone (GnomeDbTableField *field);
Get field
's extra attributes. The attributes
is an OR'ed value of all the possible
values in GnomeDbTableFieldAttribute.
field : |
a GnomeDbTableField object |
Returns : | the new attributes value |
void gnome_db_table_field_set_attributes (GnomeDbTableField *field, guint attributes);
field : |
|
attributes : |
guint gnome_db_table_field_get_attributes (GnomeDbTableField *field);
field : |
|
Returns : |