![]() |
![]() |
![]() |
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 . |