Top |
GdaDataModel columnsGdaDataModel columns — Management of GdaDataModel column attributes |
GdaColumn * | gda_column_new () |
GdaColumn * | gda_column_copy () |
const gchar * | gda_column_get_name () |
const gchar * | gda_column_get_description () |
const gchar * | gda_column_get_dbms_type () |
GType | gda_column_get_g_type () |
gboolean | gda_column_get_allow_null () |
gboolean | gda_column_get_auto_increment () |
gint | gda_column_get_position () |
const GValue * | gda_column_get_default_value () |
const GValue * | gda_column_get_attribute () |
void | gda_column_set_attribute () |
#define | gda_column_set_attribute_static() |
GdaColumn *
gda_column_copy (GdaColumn *column
);
Creates a new GdaColumn object from an existing one.
gboolean
gda_column_get_allow_null (GdaColumn *column
);
Gets the 'allow null' flag of the given column.
const GValue *
gda_column_get_default_value (GdaColumn *column
);
const GValue * gda_column_get_attribute (GdaColumn *column
,const gchar *attribute
);
Get the value associated to a named attribute.
Attributes can have any name, but Libgda proposes some default names, see this section.
void gda_column_set_attribute (GdaColumn *column
,const gchar *attribute
,const GValue *value
,GDestroyNotify destroy
);
Set the value associated to a named attribute. The attribute
string is 'stolen' by this method, and
the memory it uses will be freed using the destroy
function when no longer needed (if destroy
is NULL
,
then the string will not be freed at all).
Attributes can have any name, but Libgda proposes some default names, see this section.
If there is already an attribute named attribute
set, then its value is replaced with the new value (value
is
copied), except if value
is NULL
, in which case the attribute is removed.
For example one would use it as:
gda_column_set_attribute (holder, g_strdup (my_attribute), g_free, my_value);
gda_column_set_attribute (holder, GDA_ATTRIBUTE_NAME, NULL, my_value);
Note: this method does not modify in any way the contents of the data model for which column
is a column (nor
does it modify the table definition of the tables used by a SELECT statement is the model was created from a
SELECT statement).
column |
||
attribute |
attribute name as a static string |
|
value |
[allow-none] | |
destroy |
a function to be called when |
[allow-none] |
#define gda_column_set_attribute_static(holder,attribute,value) gda_column_set_attribute((holder),(attribute),(value),NULL)
This function is similar to gda_column_set_attribute()
but for static strings
holder |
||
attribute |
attribute's name |
|
value |
the value to set the attribute to, or |
[allow-none] |
“g-type-changed”
signalvoid user_function (GdaColumn *column, GType *old_type, GType *new_type, gpointer user_data)
Gets emitted whenever column
's type has been changed
column |
the GdaColumn object |
|
old_type |
the column's previous type |
|
new_type |
the column's new type |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“name-changed”
signalvoid user_function (GdaColumn *column, char *old_name, gpointer user_data)
Gets emitted whenever column
's name has been changed
column |
the GdaColumn object |
|
old_name |
the column's previous name |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last