GData Reference Manual: GDataGContactLanguage

## GDataGContactLanguage GDataGContactLanguage — gContact language element |

## Stability Level

Unstable, unless otherwise indicated

## Synopsis

    #include <gdata/gcontact/gdata-gcontact-language.h>

                        GDataGContactLanguage;
                        GDataGContactLanguageClass;
    GDataGContactLanguage * gdata_gcontact_language_new     (const gchar *code,
                                                             const gchar *label);
    const gchar *       gdata_gcontact_language_get_code    (GDataGContactLanguage *self);
    void                gdata_gcontact_language_set_code    (GDataGContactLanguage *self,
                                                             const gchar *code);
    const gchar *       gdata_gcontact_language_get_label   (GDataGContactLanguage *self);
    void                gdata_gcontact_language_set_label   (GDataGContactLanguage *self,
                                                             const gchar *label);

## Object Hierarchy

      GObject
       +----GDataParsable
             +----GDataGContactLanguage

## Implemented Interfaces

GDataGContactLanguage implements GDataComparable.

## Properties

      "code"                     gchar*                : Read / Write
      "label"                    gchar*                : Read / Write

## Description

GDataGContactLanguage represents a "language" element from the gContact specification.

## Details

### GDataGContactLanguage

    typedef struct _GDataGContactLanguage GDataGContactLanguage;

All the fields in the GDataGContactLanguage structure are private and should never be accessed directly.

Since 0.7.0

### GDataGContactLanguageClass

    typedef struct {
    } GDataGContactLanguageClass;

All the fields in the GDataGContactLanguageClass structure are private and should never be accessed directly.

Since 0.7.0

### gdata_gcontact_language_new ()

    GDataGContactLanguage * gdata_gcontact_language_new     (const gchar *code,
                                                             const gchar *label);

Creates a new GDataGContactLanguage. More information is available in the gContact specification.

Exactly one of `code` and `label` should be provided; the other must be `NULL`.

`code` : | the language code, or `NULL`. [allow-none]
`label` : | a free-form label for the language, or `NULL`. [allow-none]
Returns : | a new GDataGContactLanguage; unref with `g_object_unref()`

Since 0.7.0

### gdata_gcontact_language_get_code ()

    const gchar *       gdata_gcontact_language_get_code    (GDataGContactLanguage *self);

Gets the "code" property.

`self` : | a GDataGContactLanguage
Returns : | the language's code, or `NULL`

Since 0.7.0

### gdata_gcontact_language_set_code ()

    void                gdata_gcontact_language_set_code    (GDataGContactLanguage *self,
                                                             const gchar *code);

Sets the "code" property to `code`.

If `code` is `NULL`, the code will be unset. When the GDataGContactLanguage is used in a query, however, exactly one of "code" and "label" must be `NULL`.

`self` : | a GDataGContactLanguage
`code` : | the new code for the language, or `NULL`. [allow-none]

Since 0.7.0

### gdata_gcontact_language_get_label ()

    const gchar *       gdata_gcontact_language_get_label   (GDataGContactLanguage *self);

Gets the "label" property.

`self` : | a GDataGContactLanguage
Returns : | a free-form label for the language, or `NULL`

Since 0.7.0

### gdata_gcontact_language_set_label ()

    void                gdata_gcontact_language_set_label   (GDataGContactLanguage *self,
                                                             const gchar *label);

Sets the "label" property to `label`.

If `label` is `NULL`, the label will be unset. When the GDataGContactLanguage is used in a query, however, exactly one of "code" and "label" must be `NULL`.

`self` : | a GDataGContactLanguage
`label` : | the new free-form label for the language, or `NULL`. [allow-none]

Since 0.7.0

## Property Details

### The `"code"` property

      "code"                     gchar*                : Read / Write

A code identifying the language, conforming to the IETF BCP 47 specification. It is mutually exclusive with "label".

For more information, see the gContact specification.

Default value: NULL

Since 0.7.0

### The `"label"` property

      "label"                    gchar*                : Read / Write

A free-form string that identifies the language. It is mutually exclusive with "code".

For more information, see the gContact specification.

Default value: NULL

Since 0.7.0