set_attribute

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 this 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).

Parameters:

this	a Column
attribute	attribute name as a static string
value	a Value, or null
destroy	a function to be called when attribute is not needed anymore, or null