| GData Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
#include <gdata/atom/gdata-category.h>
GDataCategory;
GDataCategoryClass;
GDataCategory * gdata_category_new (const gchar *term,
const gchar *scheme,
const gchar *label);
gint gdata_category_compare (const GDataCategory *a,
const GDataCategory *b);
const gchar * gdata_category_get_term (GDataCategory *self);
void gdata_category_set_term (GDataCategory *self,
const gchar *term);
const gchar * gdata_category_get_scheme (GDataCategory *self);
void gdata_category_set_scheme (GDataCategory *self,
const gchar *scheme);
const gchar * gdata_category_get_label (GDataCategory *self);
void gdata_category_set_label (GDataCategory *self,
const gchar *label);
"label" gchar* : Read / Write "scheme" gchar* : Read / Write "term" gchar* : Read / Write
typedef struct _GDataCategory GDataCategory;
All the fields in the GDataCategory structure are private and should never be accessed directly.
typedef struct {
} GDataCategoryClass;
All the fields in the GDataCategoryClass structure are private and should never be accessed directly.
Since 0.4.0
GDataCategory * gdata_category_new (const gchar *term,const gchar *scheme,const gchar *label);
Creates a new GDataCategory. More information is available in the Atom specification.
|
a category identifier |
|
an IRI to define the categorisation scheme, or NULL
|
|
a human-readable label for the category, or NULL
|
Returns : |
a new GDataCategory, or NULL; unref with g_object_unref()
|
gint gdata_category_compare (const GDataCategory *a,const GDataCategory *b);
Compares the two categories in a strcmp() fashion. NULL values are handled gracefully, with
0 returned if both a and b are NULL, -1 if a is NULL and 1 if b is NULL.
The comparison of non-NULL values is done on the basis of the term property of the GDataCategorys.
|
a GDataCategory, or NULL
|
|
another GDataCategory, or NULL
|
Returns : |
0 if a equals b, -1 or 1 as appropriate otherwise
|
Since 0.4.0
const gchar * gdata_category_get_term (GDataCategory *self);
Gets the "term" property.
|
a GDataCategory |
Returns : |
the category's term |
Since 0.4.0
void gdata_category_set_term (GDataCategory *self,const gchar *term);
Sets the "term" property to term.
|
a GDataCategory |
|
the new term for the category |
Since 0.4.0
const gchar * gdata_category_get_scheme (GDataCategory *self);
Gets the "scheme" property.
|
a GDataCategory |
Returns : |
the category's scheme, or NULL
|
Since 0.4.0
void gdata_category_set_scheme (GDataCategory *self,const gchar *scheme);
Sets the "scheme" property to scheme.
Set scheme to NULL to unset the property in the category.
|
a GDataCategory |
|
the new scheme for the category, or NULL
|
Since 0.4.0
const gchar * gdata_category_get_label (GDataCategory *self);
Gets the "label" property.
|
a GDataCategory |
Returns : |
the category's label, or NULL
|
Since 0.4.0
void gdata_category_set_label (GDataCategory *self,const gchar *label);
Sets the "label" property to label.
Set label to NULL to unset the property in the category.
|
a GDataCategory |
|
the new label for the category, or NULL
|
Since 0.4.0
"label" property"label" gchar* : Read / Write
A human-readable label for display in end-user applications.
For more information, see the Atom specification.
Default value: NULL
Since 0.4.0
"scheme" property"scheme" gchar* : Read / Write
An IRI that identifies a categorization scheme.
For more information, see the Atom specification.
Default value: NULL
Since 0.4.0
"term" property"term" gchar* : Read / Write
Identifies the category to which the entry or feed belongs.
For more information, see the Atom specification.
Default value: NULL
Since 0.4.0