![]() |
![]() |
![]() |
GData Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <gdata/gd/gdata-gd-who.h> GDataGDWho; GDataGDWhoClass; GDataGDWho * gdata_gd_who_new (const gchar *relation_type
,const gchar *value_string
,const gchar *email_address
); gint gdata_gd_who_compare (const GDataGDWho *a
,const GDataGDWho *b
); const gchar * gdata_gd_who_get_relation_type (GDataGDWho *self
); void gdata_gd_who_set_relation_type (GDataGDWho *self
,const gchar *relation_type
); const gchar * gdata_gd_who_get_value_string (GDataGDWho *self
); void gdata_gd_who_set_value_string (GDataGDWho *self
,const gchar *value_string
); const gchar * gdata_gd_who_get_email_address (GDataGDWho *self
); void gdata_gd_who_set_email_address (GDataGDWho *self
,const gchar *email_address
);
"email-address" gchar* : Read / Write "relation-type" gchar* : Read / Write "value-string" gchar* : Read / Write
typedef struct _GDataGDWho GDataGDWho;
All the fields in the GDataGDWho structure are private and should never be accessed directly.
Since 0.2.0
typedef struct { } GDataGDWhoClass;
All the fields in the GDataGDWhoClass structure are private and should never be accessed directly.
Since 0.4.0
GDataGDWho * gdata_gd_who_new (const gchar *relation_type
,const gchar *value_string
,const gchar *email_address
);
Creates a new GDataGDWho. More information is available in the GData specification.
Currently, entryLink functionality is not implemented in GDataGDWho.
|
the relationship between the item and this person, or NULL
|
|
a string to represent the person, or NULL
|
|
the person's e-mail address, or NULL
|
Returns : |
a new GDataGDWho; unref with g_object_unref()
|
Since 0.2.0
gint gdata_gd_who_compare (const GDataGDWho *a
,const GDataGDWho *b
);
Compares the two people 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 email
and value_string
properties of the GDataGDWhos.
|
a GDataGDWho, or NULL
|
|
another GDataGDWho, or NULL
|
Returns : |
0 if a equals b , -1 or 1 as
appropriate otherwise
|
Since 0.4.0
const gchar * gdata_gd_who_get_relation_type (GDataGDWho *self
);
Gets the "relation-type" property.
|
a GDataGDWho |
Returns : |
the relation type, or NULL
|
Since 0.4.0
void gdata_gd_who_set_relation_type (GDataGDWho *self
,const gchar *relation_type
);
Sets the "relation-type" property to relation_type
.
Set relation_type
to NULL
to unset the property.
|
a GDataGDWho |
|
the new relation type |
Since 0.4.0
const gchar * gdata_gd_who_get_value_string (GDataGDWho *self
);
Gets the "value-string" property.
|
a GDataGDWho |
Returns : |
the value string, or NULL
|
Since 0.4.0
void gdata_gd_who_set_value_string (GDataGDWho *self
,const gchar *value_string
);
Sets the "value-string" property to value_string
.
Set value_string
to NULL
to unset the property.
|
a GDataGDWho |
|
the new value string, or NULL
|
Since 0.4.0
const gchar * gdata_gd_who_get_email_address (GDataGDWho *self
);
Gets the "email-address" property.
|
a GDataGDWho |
Returns : |
the e-mail address, or NULL
|
Since 0.4.0
void gdata_gd_who_set_email_address (GDataGDWho *self
,const gchar *email_address
);
Sets the "email-address" property to email_address
.
Set email_address
to NULL
to unset the property.
|
a GDataGDWho |
|
the new e-mail address, or NULL
|
Since 0.4.0
"email-address"
property"email-address" gchar* : Read / Write
The e-mail address of the person represented by the GDataGDWho.
For more information, see the GData specification.
Default value: NULL
Since 0.4.0
"relation-type"
property"relation-type" gchar* : Read / Write
Specifies the relationship between the containing entity and the contained person.
For more information, see the GData specification.
Default value: NULL
Since 0.4.0
"value-string"
property"value-string" gchar* : Read / Write
A simple string value that can be used as a representation of this person.
For more information, see the GData specification.
Default value: NULL
Since 0.4.0