Language Utilities: GNOME Desktop Library Reference Manual

Language Utilities

Functions

char **	gnome_get_all_locales ()
char *	gnome_get_country_from_code ()
char *	gnome_get_country_from_locale ()
gboolean	gnome_get_input_source_from_locale ()
char *	gnome_get_language_from_code ()
char *	gnome_get_language_from_locale ()
char *	gnome_normalize_locale ()
gboolean	gnome_parse_locale ()
gboolean	gnome_language_has_translations ()

Description

Functions

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.

Parameters

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.

Parameters

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.

Parameters

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.

Parameters

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.

Parameters

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[modifier ]] for name .

Parameters

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[modifier ]]. See http://en.wikipedia.org/wiki/Locale.

Parameters

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 .

Parameters

code

an ISO 639 code string

Returns

TRUE if there are translations for language code .

Since: 3.8