![]() |
![]() |
![]() |
GNOME Data Access 5 manual | ![]() |
---|---|---|---|---|
Top | Description |
#define GDA_ATTRIBUTE_NAME #define GDA_ATTRIBUTE_DESCRIPTION #define GDA_ATTRIBUTE_AUTO_INCREMENT #define GDA_ATTRIBUTE_NUMERIC_PRECISION #define GDA_ATTRIBUTE_NUMERIC_SCALE #define GDA_ATTRIBUTE_IS_DEFAULT GdaAttributesManager; void (*GdaAttributesManagerSignal) (GObject *obj
,const gchar *att_name
,const GValue *value
,gpointer data
); void (*GdaAttributesManagerFunc) (const gchar *att_name
,const GValue *value
,gpointer data
); GdaAttributesManager * gda_attributes_manager_new (gboolean for_objects
,GdaAttributesManagerSignal signal_func
,gpointer signal_data
); void gda_attributes_manager_free (GdaAttributesManager *mgr
); void gda_attributes_manager_set (GdaAttributesManager *mgr
,gpointer ptr
,const gchar *att_name
,const GValue *value
); void gda_attributes_manager_set_full (GdaAttributesManager *mgr
,gpointer ptr
,const gchar *att_name
,const GValue *value
,GDestroyNotify destroy
); const GValue * gda_attributes_manager_get (GdaAttributesManager *mgr
,gpointer ptr
,const gchar *att_name
); void gda_attributes_manager_copy (GdaAttributesManager *from_mgr
,gpointer *from
,GdaAttributesManager *to_mgr
,gpointer *to
); void gda_attributes_manager_clear (GdaAttributesManager *mgr
,gpointer ptr
); void gda_attributes_manager_foreach (GdaAttributesManager *mgr
,gpointer ptr
,GdaAttributesManagerFunc func
,gpointer data
);
#define GDA_ATTRIBUTE_AUTO_INCREMENT "__gda_attr_autoinc" /* G_TYPE_BOOLEAN */
#define GDA_ATTRIBUTE_NUMERIC_PRECISION "__gda_attr_numeric_precision" /* G_TYPE_INT */
#define GDA_ATTRIBUTE_NUMERIC_SCALE "__gda_attr_numeric_scale" /* G_TYPE_INT */
#define GDA_ATTRIBUTE_IS_DEFAULT "__gda_attr_is_default" /* G_TYPE_BOOLEAN */
void (*GdaAttributesManagerSignal) (GObject *obj
,const gchar *att_name
,const GValue *value
,gpointer data
);
void (*GdaAttributesManagerFunc) (const gchar *att_name
,const GValue *value
,gpointer data
);
GdaAttributesManager * gda_attributes_manager_new (gboolean for_objects
,GdaAttributesManagerSignal signal_func
,gpointer signal_data
);
Creates a new GdaAttributesManager, which can store (name, value) attributes for pointers or GObject objects (in the latter case, the attributes are destroyed when objects are also destroyed).
Free-function: gda_attributes_manager_free
|
set to TRUE if attributes will be set on objects. |
|
a function to be called whenever an attribute changes on an object (if for_objects is TRUE), or NULL
|
|
user data passed as last argument of signal_func when it is called |
Returns : |
the new GdaAttributesManager |
void gda_attributes_manager_free (GdaAttributesManager *mgr
);
Frees all the resssources managed by mgr
|
a GdaAttributesManager |
void gda_attributes_manager_set (GdaAttributesManager *mgr
,gpointer ptr
,const gchar *att_name
,const GValue *value
);
Associates an attribute named att_name
to ptr
, with the value value
. Any previous association is replaced by
this one, and if value
is NULL
then the association is removed.
Note: att_name
is *not* copied, so it should be a string which exists as long as mgr
exists.
Libgda provides several predefined names for common attributes,
see this section.
If att_name
needs to be freed when not used anymore, then use gda_attributes_manager_set_full()
.
|
a GdaAttributesManager |
|
a pointer to the resources to which the attribute will apply |
|
an attribute's name |
|
a GValue, or NULL
|
void gda_attributes_manager_set_full (GdaAttributesManager *mgr
,gpointer ptr
,const gchar *att_name
,const GValue *value
,GDestroyNotify destroy
);
Does the same as gda_attributes_manager_set()
except that destroy
is called when att_name
needs
to be freed.
|
a GdaAttributesManager |
|
a pointer to the resources to which the attribute will apply |
|
an attribute's name |
|
a GValue, or NULL
|
|
function called when att_name has to be freed |
const GValue * gda_attributes_manager_get (GdaAttributesManager *mgr
,gpointer ptr
,const gchar *att_name
);
Retrieves the value of an attribute previously set using gda_attributes_manager_set()
.
|
a GdaAttributesManager |
|
a pointer to the resources to which the attribute will apply |
|
an attribute's name |
Returns : |
the attribute's value, or NULL if the attribute is not set. [tranfer none]
|
void gda_attributes_manager_copy (GdaAttributesManager *from_mgr
,gpointer *from
,GdaAttributesManager *to_mgr
,gpointer *to
);
For each attribute set for from
(in from_mgr
), set the same attribute to to
(in to_mgr
). from_mgr
and
to_mgr
can be equal.
|
a GdaAttributesManager |
|
a pointer from which attributes are copied |
|
a GdaAttributesManager |
|
a pointer to which attributes are copied |
void gda_attributes_manager_clear (GdaAttributesManager *mgr
,gpointer ptr
);
Remove all the attributes managed by mgr
for the ptr
resource.
|
a GdaAttributesManager |
|
a pointer to the resources for which all the attributes will be removed |
void gda_attributes_manager_foreach (GdaAttributesManager *mgr
,gpointer ptr
,GdaAttributesManagerFunc func
,gpointer data
);
Calls func
for every attribute set to ptr
.
|
a GdaAttributesManager |
|
a pointer to the resources for which all the attributes used |
|
a GdaAttributesManagerFunc function. [scope call] |
|
user data to be passed as last argument of func each time it is called. [closure]
|