|  |  |  | 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 withg_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 : | 0ifaequalsb,-1or1as
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