| liblangtag Documentation | ||||
|---|---|---|---|---|
| Top | Description | ||||
char * lt_tag_canonicalize (lt_tag_t *tag,lt_error_t **error); void lt_tag_clear (lt_tag_t *tag); lt_bool_t lt_tag_compare (const lt_tag_t *v1,const lt_tag_t *v2); lt_tag_t * lt_tag_convert_from_locale (lt_error_t **error); lt_tag_t * lt_tag_convert_from_locale_string (const char *locale,lt_error_t **error); char * lt_tag_convert_to_locale (lt_tag_t *tag,lt_error_t **error); lt_tag_t * lt_tag_copy (const lt_tag_t *tag); void lt_tag_dump (const lt_tag_t *tag); const lt_extension_t * lt_tag_get_extension (const lt_tag_t *tag); const lt_extlang_t * lt_tag_get_extlang (const lt_tag_t *tag); const lt_grandfathered_t * lt_tag_get_grandfathered (const lt_tag_t *tag); const lt_lang_t * lt_tag_get_language (const lt_tag_t *tag); const lt_string_t * lt_tag_get_privateuse (const lt_tag_t *tag); const lt_region_t * lt_tag_get_region (const lt_tag_t *tag); const lt_script_t * lt_tag_get_script (const lt_tag_t *tag); const char * lt_tag_get_string (lt_tag_t *tag); const lt_list_t * lt_tag_get_variants (const lt_tag_t *tag); char * lt_tag_lookup (const lt_tag_t *tag,const char *pattern,lt_error_t **error); lt_bool_t lt_tag_match (const lt_tag_t *v1,const char *v2,lt_error_t **error); lt_tag_t * lt_tag_new (void); lt_bool_t lt_tag_parse (lt_tag_t *tag,const char *tag_string,lt_error_t **error); lt_bool_t lt_tag_parse_with_extra_token (lt_tag_t *tag,const char *tag_string,lt_error_t **error); lt_tag_t * lt_tag_ref (lt_tag_t *tag); lt_tag_t; char * lt_tag_transform (lt_tag_t *tag,lt_error_t **error); lt_bool_t lt_tag_truncate (lt_tag_t *tag,lt_error_t **error); void lt_tag_unref (lt_tag_t *tag);
char * lt_tag_canonicalize (lt_tag_t *tag,lt_error_t **error);
Canonicalize the language tag according to various information of subtags.
|
a lt_tag_t. |
|
a lt_error_t or NULL. [allow-none]
|
Returns : |
a language tag string. |
void lt_tag_clear (lt_tag_t *tag);
(Re-)Initialize all of the subtag information stored in tag.
|
a lt_tag_t. |
lt_bool_t lt_tag_compare (const lt_tag_t *v1,const lt_tag_t *v2);
Compare if v1 and v2 is the same object or not.
lt_tag_t * lt_tag_convert_from_locale (lt_error_t **error);
Convert current locale to the language tag.
|
a lt_error_t. [allow-none] |
Returns : |
a lt_tag_t, NULL if fails. [transfer full]
|
lt_tag_t * lt_tag_convert_from_locale_string (const char *locale,lt_error_t **error);
Convert locale to the language tag.
|
a locale string |
|
a lt_error_t or NULL. [allow-none]
|
Returns : |
a lt_tag_t, NULL if fails. [transfer full]
|
char * lt_tag_convert_to_locale (lt_tag_t *tag,lt_error_t **error);
Convert the language tag to the locale.
|
a lt_tag_t. |
|
a lt_error_t or NULL. [allow-none]
|
Returns : |
a locale string or NULL if fails |
void lt_tag_dump (const lt_tag_t *tag);
Dumps the container information to the standard output.
|
a lt_tag_t. |
const lt_extension_t * lt_tag_get_extension (const lt_tag_t *tag);
Obtain a lt_extension_t instance in tag.
|
a lt_tag_t. |
Returns : |
a lt_extension_t. [transfer none] |
const lt_extlang_t * lt_tag_get_extlang (const lt_tag_t *tag);
Obtain a lt_extlang_t instance in tag.
|
a lt_tag_t. |
Returns : |
a lt_extlang_t. [transfer none] |
const lt_grandfathered_t * lt_tag_get_grandfathered (const lt_tag_t *tag);
Obtain a lt_grandfathered_t instance in tag.
|
a lt_tag_t. |
Returns : |
a lt_grandfathered_t. [transfer none] |
const lt_lang_t * lt_tag_get_language (const lt_tag_t *tag);
Obtain a lt_lang_t instance in tag.
const lt_string_t * lt_tag_get_privateuse (const lt_tag_t *tag);
Obtain a lt_string_t instance in tag.
|
a lt_tag_t. |
Returns : |
a lt_string_t. [transfer none] |
const lt_region_t * lt_tag_get_region (const lt_tag_t *tag);
Obtain a lt_region_t instance in tag.
|
a lt_tag_t. |
Returns : |
a lt_region_t. [transfer none] |
const lt_script_t * lt_tag_get_script (const lt_tag_t *tag);
Obtain a lt_script_t instance in tag.
|
a lt_tag_t. |
Returns : |
a lt_script_t. [transfer none] |
const char * lt_tag_get_string (lt_tag_t *tag);
Obtains a language tag in string.
|
a lt_tag_t. |
Returns : |
a language tag string. |
const lt_list_t * lt_tag_get_variants (const lt_tag_t *tag);
Obtain a list of lt_variant_t instance in tag.
|
a lt_tag_t. |
Returns : |
a lt_list_t containing lt_variant_t. [transfer none] |
char * lt_tag_lookup (const lt_tag_t *tag,const char *pattern,lt_error_t **error);
Lookup the language tag that tag meets with pattern.
Any of subtags in pattern is allowed to use the wildcard according to
the syntax in RFC 4647.
|
a lt_tag_t. |
|
a language range string. |
|
a lt_error_t or NULL. [allow-none]
|
Returns : |
a language tag string if any matches, otherwise NULL. |
lt_bool_t lt_tag_match (const lt_tag_t *v1,const char *v2,lt_error_t **error);
Try matching of v1 and v2. any of subtags in v2 is allowed to use
the wildcard according to the syntax in RFC 4647.
|
a lt_tag_t. |
|
a language range string. |
|
a lt_error_t or NULL. [allow-none]
|
Returns : |
TRUE if it matches, otherwise FALSE. |
lt_tag_t * lt_tag_new (void);
Create a new instance of lt_tag_t.
Returns : |
a new instance of lt_tag_t. [transfer full] |
lt_bool_t lt_tag_parse (lt_tag_t *tag,const char *tag_string,lt_error_t **error);
Parse tag_string and create appropriate instances for subtags.
|
a lt_tag_t. |
|
language tag to be parsed. |
|
a lt_error_t or NULL. [allow-none]
|
Returns : |
TRUE if it's successfully completed, otherwise FALSE. |
lt_bool_t lt_tag_parse_with_extra_token (lt_tag_t *tag,const char *tag_string,lt_error_t **error);
Continue to parse a language tag with tag_string. please use lt_tag_parse()
at first.
|
a lt_tag_t. |
|
a language tag to be parsed much more. |
|
a lt_error_t or NULL. [allow-none]
|
Returns : |
TRUE if it's successfully completed, otherwise FALSE. |
lt_tag_t * lt_tag_ref (lt_tag_t *tag);
Increases the reference count of tag.
|
a lt_tag_t. |
Returns : |
the same tag object. [transfer none]
|
typedef struct _lt_tag_t lt_tag_t;
All the fields in the lt_tag_t structure are private to the lt_tag_t implementation.
char * lt_tag_transform (lt_tag_t *tag,lt_error_t **error);
Transform tag according to the likelySubtags database provided by CLDR.
|
a lt_tag_t. |
|
a lt_error_t or NULL. [allow-none]
|
Returns : |
a string. |
lt_bool_t lt_tag_truncate (lt_tag_t *tag,lt_error_t **error);
Truncate the last subtag.
|
a lt_tag_t. |
|
a lt_error_t. [allow-none] |
Returns : |
TRUE if a subtag was truncated, otherwise FALSE. |