![]() |
![]() |
![]() |
GData Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <gdata/atom/gdata-author.h> GDataAuthor; GDataAuthorClass; GDataAuthor * gdata_author_new (const gchar *name, const gchar *uri, const gchar *email_address); gint gdata_author_compare (const GDataAuthor *a, const GDataAuthor *b); const gchar * gdata_author_get_name (GDataAuthor *self); void gdata_author_set_name (GDataAuthor *self, const gchar *name); const gchar * gdata_author_get_uri (GDataAuthor *self); void gdata_author_set_uri (GDataAuthor *self, const gchar *uri); const gchar * gdata_author_get_email_address (GDataAuthor *self); void gdata_author_set_email_address (GDataAuthor *self, const gchar *email_address);
"email-address" gchar* : Read / Write "name" gchar* : Read / Write "uri" gchar* : Read / Write
typedef struct _GDataAuthor GDataAuthor;
All the fields in the GDataAuthor structure are private and should never be accessed directly.
typedef struct { } GDataAuthorClass;
All the fields in the GDataAuthorClass structure are private and should never be accessed directly.
Since 0.4.0
GDataAuthor * gdata_author_new (const gchar *name, const gchar *uri, const gchar *email_address);
Creates a new GDataAuthor. More information is available in the Atom specification.
|
the author's name |
|
an IRI describing the author, or NULL
|
|
the author's e-mail address, or NULL
|
Returns : |
a new GDataAuthor, or NULL ; unref with g_object_unref()
|
gint gdata_author_compare (const GDataAuthor *a, const GDataAuthor *b);
Compares the two authors 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 name
property of the GDataAuthors.
|
a GDataAuthor, or NULL
|
|
another GDataAuthor, or NULL
|
Returns : |
0 if a equals b , -1 or 1 as appropriate otherwise
|
Since 0.4.0
const gchar * gdata_author_get_name (GDataAuthor *self);
Gets the "name" property.
|
a GDataAuthor |
Returns : |
the author's name |
Since 0.4.0
void gdata_author_set_name (GDataAuthor *self, const gchar *name);
Sets the "name" property to name
.
|
a GDataAuthor |
|
the new name for the author |
Since 0.4.0
const gchar * gdata_author_get_uri (GDataAuthor *self);
Gets the "uri" property.
|
a GDataAuthor |
Returns : |
the author's URI, or NULL
|
Since 0.4.0
void gdata_author_set_uri (GDataAuthor *self, const gchar *uri);
Sets the "uri" property to uri
.
Set uri
to NULL
to unset the property in the author.
|
a GDataAuthor |
|
the new URI for the author, or NULL
|
Since 0.4.0
const gchar * gdata_author_get_email_address (GDataAuthor *self);
Gets the "email-address" property.
|
a GDataAuthor |
Returns : |
the author's e-mail address, or NULL
|
Since 0.4.0
void gdata_author_set_email_address (GDataAuthor *self, const gchar *email_address);
Sets the "email-address" property to email_address
.
Set email_address
to NULL
to unset the property in the author.
|
a GDataAuthor |
|
the new e-mail address for the author, or NULL
|
Since 0.4.0
"email-address"
property"email-address" gchar* : Read / Write
An e-mail address associated with the person.
For more information, see the Atom specification.
Default value: NULL
Since 0.4.0
"name"
property"name" gchar* : Read / Write
A human-readable name for the person.
For more information, see the Atom specification.
Default value: NULL
Since 0.4.0
"uri"
property"uri" gchar* : Read / Write
An IRI associated with the person.
For more information, see the Atom specification.
Default value: NULL
Since 0.4.0