|  |  |  | 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, NULLif 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, NULLif 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 NULLif 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 : | TRUEif it matches, otherwiseFALSE. | 
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 : | TRUEif it's successfully completed, otherwiseFALSE. | 
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 : | TRUEif it's successfully completed, otherwiseFALSE. | 
lt_tag_t *          lt_tag_ref                          (lt_tag_t *tag);
Increases the reference count of tag.
| 
 | a lt_tag_t. | 
| Returns : | the same tagobject. [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 : | TRUEif a subtag was truncated, otherwiseFALSE. |