![]() |
![]() |
![]() |
GData Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <gdata/gd/gdata-gd-name.h> GDataGDName; GDataGDNameClass; GDataGDName * gdata_gd_name_new (const gchar *given_name
,const gchar *family_name
); gint gdata_gd_name_compare (const GDataGDName *a
,const GDataGDName *b
); const gchar * gdata_gd_name_get_given_name (GDataGDName *self
); void gdata_gd_name_set_given_name (GDataGDName *self
,const gchar *given_name
); const gchar * gdata_gd_name_get_additional_name (GDataGDName *self
); void gdata_gd_name_set_additional_name (GDataGDName *self
,const gchar *additional_name
); const gchar * gdata_gd_name_get_family_name (GDataGDName *self
); void gdata_gd_name_set_family_name (GDataGDName *self
,const gchar *family_name
); const gchar * gdata_gd_name_get_prefix (GDataGDName *self
); void gdata_gd_name_set_prefix (GDataGDName *self
,const gchar *prefix
); const gchar * gdata_gd_name_get_suffix (GDataGDName *self
); void gdata_gd_name_set_suffix (GDataGDName *self
,const gchar *suffix
); const gchar * gdata_gd_name_get_full_name (GDataGDName *self
); void gdata_gd_name_set_full_name (GDataGDName *self
,const gchar *full_name
);
"additional-name" gchar* : Read / Write "family-name" gchar* : Read / Write "full-name" gchar* : Read / Write "given-name" gchar* : Read / Write "prefix" gchar* : Read / Write "suffix" gchar* : Read / Write
GDataGDName represents a "name" element from the GData specification.
Given a name such as Sir Winston Leonard Spencer-Churchill, KG
, the properties of the GDataGDName should be
set as follows:
Winston |
|
Leonard |
|
Spencer-Churchill |
|
Sir |
|
KG |
typedef struct _GDataGDName GDataGDName;
All the fields in the GDataGDName structure are private and should never be accessed directly.
Since 0.5.0
typedef struct { } GDataGDNameClass;
All the fields in the GDataGDNameClass structure are private and should never be accessed directly.
Since 0.5.0
GDataGDName * gdata_gd_name_new (const gchar *given_name
,const gchar *family_name
);
Creates a new GDataGDName. More information is available in the GData specification.
|
the person's given name, or NULL . [allow-none]
|
|
the person's family name, or NULL . [allow-none]
|
Returns : |
a new GDataGDName, or NULL ; unref with g_object_unref()
|
Since 0.5.0
gint gdata_gd_name_compare (const GDataGDName *a
,const GDataGDName *b
);
Compares the two names 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 given_name
, additional_name
and family_name
properties of the
GDataGDNames.
|
a GDataGDName, or NULL
|
|
another GDataGDName, or NULL
|
Returns : |
0 if a equals b , -1 or 1 as
appropriate otherwise |
Since 0.5.0
const gchar * gdata_gd_name_get_given_name (GDataGDName *self
);
Gets the "given-name" property.
|
a GDataGDName |
Returns : |
the person's given name, or NULL
|
Since 0.5.0
void gdata_gd_name_set_given_name (GDataGDName *self
,const gchar *given_name
);
Sets the "given-name" property to given_name
.
|
a GDataGDName |
|
the new given name, or NULL . [allow-none]
|
Since 0.5.0
const gchar * gdata_gd_name_get_additional_name (GDataGDName *self
);
Gets the "additional-name" property.
|
a GDataGDName |
Returns : |
the person's additional name, or NULL
|
Since 0.5.0
void gdata_gd_name_set_additional_name (GDataGDName *self
,const gchar *additional_name
);
Sets the "additional-name" property to additional_name
.
|
a GDataGDName |
|
the new additional name, or NULL . [allow-none]
|
Since 0.5.0
const gchar * gdata_gd_name_get_family_name (GDataGDName *self
);
Gets the "family-name" property.
|
a GDataGDName |
Returns : |
the person's family name, or NULL
|
Since 0.5.0
void gdata_gd_name_set_family_name (GDataGDName *self
,const gchar *family_name
);
Sets the "family-name" property to family_name
.
|
a GDataGDName |
|
the new family name, or NULL . [allow-none]
|
Since 0.5.0
const gchar * gdata_gd_name_get_prefix (GDataGDName *self
);
Gets the "prefix" property.
|
a GDataGDName |
Returns : |
the person's name prefix, or NULL
|
Since 0.5.0
void gdata_gd_name_set_prefix (GDataGDName *self
,const gchar *prefix
);
Sets the "prefix" property to prefix
.
|
a GDataGDName |
|
the new prefix, or NULL . [allow-none]
|
Since 0.5.0
const gchar * gdata_gd_name_get_suffix (GDataGDName *self
);
Gets the "suffix" property.
|
a GDataGDName |
Returns : |
the person's name suffix, or NULL
|
Since 0.5.0
void gdata_gd_name_set_suffix (GDataGDName *self
,const gchar *suffix
);
Sets the "suffix" property to suffix
.
|
a GDataGDName |
|
the new suffix, or NULL . [allow-none]
|
Since 0.5.0
const gchar * gdata_gd_name_get_full_name (GDataGDName *self
);
Gets the "full-name" property.
|
a GDataGDName |
Returns : |
the person's full name, or NULL
|
Since 0.5.0
void gdata_gd_name_set_full_name (GDataGDName *self
,const gchar *full_name
);
Sets the "full-name" property to full_name
.
|
a GDataGDName |
|
the new full name, or NULL . [allow-none]
|
Since 0.5.0
"additional-name"
property"additional-name" gchar* : Read / Write
An additional name for the person (e.g. a middle name).
For more information, see the GData specification.
Default value: NULL
Since 0.5.0
"family-name"
property"family-name" gchar* : Read / Write
The person's family name.
For more information, see the GData specification.
Default value: NULL
Since 0.5.0
"full-name"
property"full-name" gchar* : Read / Write
An unstructured representation of the person's full name. It's generally advised to use the other individual properties in preference to this one, which can fall out of synchronisation with the other properties.
For more information, see the GData specification.
Default value: NULL
Since 0.5.0
"given-name"
property"given-name" gchar* : Read / Write
The person's given name.
For more information, see the GData specification.
Default value: NULL
Since 0.5.0
"prefix"
property"prefix" gchar* : Read / Write
An honorific prefix (e.g. Mr
or Mrs
).
For more information, see the GData specification.
Default value: NULL
Since 0.5.0
"suffix"
property"suffix" gchar* : Read / Write
An honorific suffix (e.g. san
or III
).
For more information, see the GData specification.
Default value: NULL
Since 0.5.0