| 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