1 // © 2016 and later: Unicode, Inc. and others.
2 // License & terms of use: http://www.unicode.org/copyright.html
3 /*
4 **********************************************************************
5 *   Copyright (C) 2004-2016, International Business Machines
6 *   Corporation and others.  All Rights Reserved.
7 **********************************************************************
8 */
9 
10 #ifndef ULOCIMP_H
11 #define ULOCIMP_H
12 
13 #include "unicode/uloc.h"
14 
15 /**
16  * Create an iterator over the specified keywords list
17  * @param keywordList double-null terminated list. Will be copied.
18  * @param keywordListSize size in bytes of keywordList
19  * @param status err code
20  * @return enumeration (owned by caller) of the keyword list.
21  * @internal ICU 3.0
22  */
23 U_CAPI UEnumeration* U_EXPORT2
24 uloc_openKeywordList(const char *keywordList, int32_t keywordListSize, UErrorCode* status);
25 
26 /**
27  * Look up a resource bundle table item with fallback on the table level.
28  * This is accessible so it can be called by C++ code.
29  */
30 U_CAPI const UChar * U_EXPORT2
31 uloc_getTableStringWithFallback(
32     const char *path,
33     const char *locale,
34     const char *tableKey,
35     const char *subTableKey,
36     const char *itemKey,
37     int32_t *pLength,
38     UErrorCode *pErrorCode);
39 
40 /*returns TRUE if a is an ID separator FALSE otherwise*/
41 #define _isIDSeparator(a) (a == '_' || a == '-')
42 
43 U_CFUNC const char*
44 uloc_getCurrentCountryID(const char* oldID);
45 
46 U_CFUNC const char*
47 uloc_getCurrentLanguageID(const char* oldID);
48 
49 U_CFUNC int32_t
50 ulocimp_getLanguage(const char *localeID,
51                     char *language, int32_t languageCapacity,
52                     const char **pEnd);
53 
54 U_CFUNC int32_t
55 ulocimp_getScript(const char *localeID,
56                    char *script, int32_t scriptCapacity,
57                    const char **pEnd);
58 
59 U_CFUNC int32_t
60 ulocimp_getCountry(const char *localeID,
61                    char *country, int32_t countryCapacity,
62                    const char **pEnd);
63 
64 /**
65  * Returns a locale ID for the specified BCP47 language tag string.
66  * If the specified language tag contains any ill-formed subtags,
67  * the first such subtag and all following subtags are ignored.
68  * <p>
69  * This implements the 'Language-Tag' production of BCP47, and so
70  * supports grandfathered (regular and irregular) as well as private
71  * use language tags.  Private use tags are represented as 'x-whatever',
72  * and grandfathered tags are converted to their canonical replacements
73  * where they exist.  Note that a few grandfathered tags have no modern
74  * replacement, these will be converted using the fallback described in
75  * the first paragraph, so some information might be lost.
76  * @param langtag   the input BCP47 language tag.
77  * @param tagLen    the length of langtag, or -1 to call uprv_strlen().
78  * @param localeID  the output buffer receiving a locale ID for the
79  *                  specified BCP47 language tag.
80  * @param localeIDCapacity  the size of the locale ID output buffer.
81  * @param parsedLength  if not NULL, successfully parsed length
82  *                      for the input language tag is set.
83  * @param err       error information if receiving the locald ID
84  *                  failed.
85  * @return          the length of the locale ID.
86  * @internal ICU 63
87  */
88 U_CAPI int32_t U_EXPORT2
89 ulocimp_forLanguageTag(const char* langtag,
90                        int32_t tagLen,
91                        char* localeID,
92                        int32_t localeIDCapacity,
93                        int32_t* parsedLength,
94                        UErrorCode* err);
95 
96 /**
97  * Get the region to use for supplemental data lookup. Uses
98  * (1) any region specified by locale tag "rg"; if none then
99  * (2) any unicode_region_tag in the locale ID; if none then
100  * (3) if inferRegion is TRUE, the region suggested by
101  * getLikelySubtags on the localeID.
102  * If no region is found, returns length 0.
103  *
104  * @param localeID
105  *     The complete locale ID (with keywords) from which
106  *     to get the region to use for supplemental data.
107  * @param inferRegion
108  *     If TRUE, will try to infer region from localeID if
109  *     no other region is found.
110  * @param region
111  *     Buffer in which to put the region ID found; should
112  *     have a capacity at least ULOC_COUNTRY_CAPACITY.
113  * @param regionCapacity
114  *     The actual capacity of the region buffer.
115  * @param status
116  *     Pointer to in/out UErrorCode value for latest status.
117  * @return
118  *     The length of any region code found, or 0 if none.
119  * @internal ICU 57
120  */
121 U_CAPI int32_t U_EXPORT2
122 ulocimp_getRegionForSupplementalData(const char *localeID, UBool inferRegion,
123                                      char *region, int32_t regionCapacity, UErrorCode* status);
124 
125 U_CAPI const char * U_EXPORT2
126 locale_getKeywordsStart(const char *localeID);
127 
128 
129 U_CFUNC UBool
130 ultag_isUnicodeLocaleKey(const char* s, int32_t len);
131 
132 U_CFUNC UBool
133 ultag_isUnicodeLocaleType(const char* s, int32_t len);
134 
135 U_CFUNC const char*
136 ulocimp_toBcpKey(const char* key);
137 
138 U_CFUNC const char*
139 ulocimp_toLegacyKey(const char* key);
140 
141 U_CFUNC const char*
142 ulocimp_toBcpType(const char* key, const char* type, UBool* isKnownKey, UBool* isSpecialType);
143 
144 U_CFUNC const char*
145 ulocimp_toLegacyType(const char* key, const char* type, UBool* isKnownKey, UBool* isSpecialType);
146 
147 #endif
148