Language Utilities

Language Utilities

Synopsis

char **             gnome_get_all_locales               (void);
char *              gnome_get_country_from_code         (const char *code,
                                                         const char *translation);
char *              gnome_get_country_from_locale       (const char *locale,
                                                         const char *translation);
gboolean            gnome_get_input_source_from_locale  (const char *locale,
                                                         const char **type,
                                                         const char **id);
char *              gnome_get_language_from_code        (const char *code,
                                                         const char *translation);
char *              gnome_get_language_from_locale      (const char *locale,
                                                         const char *translation);
char *              gnome_normalize_locale              (const char *locale);
gboolean            gnome_parse_locale                  (const char *locale,
                                                         char **language_codep,
                                                         char **country_codep,
                                                         char **codesetp,
                                                         char **modifierp);
gboolean            gnome_language_has_translations     (const char *code);

Description

Details

gnome_get_all_locales ()

char **             gnome_get_all_locales               (void);

Gets all locales.

Returns :

a newly allocated NULL-terminated string array containing the all locales. Free with g_strfreev(). [array zero-terminated=1][element-type utf8][transfer full]

Since 3.8


gnome_get_country_from_code ()

char *              gnome_get_country_from_code         (const char *code,
                                                         const char *translation);

Gets the country name for code. If locale is provided the returned string is translated accordingly.

code :

an ISO 3166 code string

translation :

a locale string. [allow-none]

Returns :

the country name. Caller takes ownership. [transfer full]

Since 3.8


gnome_get_country_from_locale ()

char *              gnome_get_country_from_locale       (const char *locale,
                                                         const char *translation);

Gets the country description for locale. If translation is provided the returned string is translated accordingly.

locale :

a locale string

translation :

a locale string. [allow-none]

Returns :

the country description. Caller takes ownership. [transfer full]

Since 3.8


gnome_get_input_source_from_locale ()

gboolean            gnome_get_input_source_from_locale  (const char *locale,
                                                         const char **type,
                                                         const char **id);

Gets the default input source's type and identifier for a given locale.

locale :

a locale string

type :

location to store the input source type. [out][transfer none]

id :

location to store the input source identifier. [out][transfer none]

Returns :

TRUE if a input source exists or FALSE otherwise.

Since 3.8


gnome_get_language_from_code ()

char *              gnome_get_language_from_code        (const char *code,
                                                         const char *translation);

Gets the language name for code. If locale is provided the returned string is translated accordingly.

code :

an ISO 639 code string

translation :

a locale string. [allow-none]

Returns :

the language name. Caller takes ownership. [transfer full]

Since 3.8


gnome_get_language_from_locale ()

char *              gnome_get_language_from_locale      (const char *locale,
                                                         const char *translation);

Gets the language description for locale. If translation is provided the returned string is translated accordingly.

locale :

a locale string

translation :

a locale string. [allow-none]

Returns :

the language description. Caller takes ownership. [transfer full]

Since 3.8


gnome_normalize_locale ()

char *              gnome_normalize_locale              (const char *locale);

Gets the normalized locale string in the form [language[_country][.codeset][modifier]] for name.

locale :

a locale string

Returns :

normalized locale string. Caller takes ownership. [transfer full]

Since 3.8


gnome_parse_locale ()

gboolean            gnome_parse_locale                  (const char *locale,
                                                         char **language_codep,
                                                         char **country_codep,
                                                         char **codesetp,
                                                         char **modifierp);

Extracts the various components of a locale string of the form [language[_country][.codeset][modifier]]. See http://en.wikipedia.org/wiki/Locale.

locale :

a locale string

language_codep :

location to store the language code, or NULL. [out][allow-none][transfer full]

country_codep :

location to store the country code, or NULL. [out][allow-none][transfer full]

codesetp :

location to store the codeset, or NULL. [out][allow-none][transfer full]

modifierp :

location to store the modifier, or NULL. [out][allow-none][transfer full]

Returns :

TRUE if parsing was successful.

Since 3.8


gnome_language_has_translations ()

gboolean            gnome_language_has_translations     (const char *code);

Returns TRUE if there are translations for language code.

code :

an ISO 639 code string

Returns :

TRUE if there are translations for language code.

Since 3.8