![]() |
![]() |
![]() |
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
"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