1 // © 2016 and later: Unicode, Inc. and others.
2 // License & terms of use: http://www.unicode.org/copyright.html
3 /*
4 *******************************************************************************
5 *
6 *   Copyright (C) 1998-2014, International Business Machines
7 *   Corporation and others.  All Rights Reserved.
8 *
9 *******************************************************************************
10 *
11 * Private implementation header for C collation
12 *   file name:  ucol_imp.h
13 *   encoding:   UTF-8
14 *   tab size:   8 (not used)
15 *   indentation:4
16 *
17 *   created on: 2000dec11
18 *   created by: Vladimir Weinstein
19 *
20 * Modification history
21 * Date        Name      Comments
22 * 02/16/2001  synwee    Added UCOL_GETPREVCE for the use in ucoleitr
23 * 02/27/2001  synwee    Added getMaxExpansion data structure in UCollator
24 * 03/02/2001  synwee    Added UCOL_IMPLICIT_CE
25 * 03/12/2001  synwee    Added pointer start to collIterate.
26 */
27 
28 #ifndef UCOL_IMP_H
29 #define UCOL_IMP_H
30 
31 #include "unicode/utypes.h"
32 
33 #if !UCONFIG_NO_COLLATION
34 
35 // This part needs to compile as plain C code, for cintltst.
36 
37 #include "unicode/ucol.h"
38 
39 /** Check whether two collators are equal. Collators are considered equal if they
40  *  will sort strings the same. This means that both the current attributes and the
41  *  rules must be equivalent.
42  *  @param source first collator
43  *  @param target second collator
44  *  @return true or false
45  *  @internal ICU 3.0
46  */
47 U_CAPI UBool U_EXPORT2
48 ucol_equals(const UCollator *source, const UCollator *target);
49 
50 /**
51  * Convenience string denoting the Collation data tree
52  */
53 #define U_ICUDATA_COLL U_ICUDATA_NAME U_TREE_SEPARATOR_STRING "coll"
54 
55 #ifdef __cplusplus
56 
57 #include "unicode/locid.h"
58 #include "unicode/ures.h"
59 
60 U_NAMESPACE_BEGIN
61 
62 struct CollationCacheEntry;
63 
64 class Locale;
65 class UnicodeString;
66 class UnifiedCache;
67 
68 /** Implemented in ucol_res.cpp. */
69 class CollationLoader {
70 public:
71     static void appendRootRules(UnicodeString &s);
72     static void loadRules(const char *localeID, const char *collationType,
73                           UnicodeString &rules, UErrorCode &errorCode);
74     // Adds a reference to returned value.
75     static const CollationCacheEntry *loadTailoring(const Locale &locale, UErrorCode &errorCode);
76 
77     // Cache callback. Adds a reference to returned value.
78     const CollationCacheEntry *createCacheEntry(UErrorCode &errorCode);
79 
80 private:
81     static void U_CALLCONV loadRootRules(UErrorCode &errorCode);
82 
83     // The following members are used by loadTailoring()
84     // and the cache callback.
85     static const uint32_t TRIED_SEARCH = 1;
86     static const uint32_t TRIED_DEFAULT = 2;
87     static const uint32_t TRIED_STANDARD = 4;
88 
89     CollationLoader(const CollationCacheEntry *re, const Locale &requested, UErrorCode &errorCode);
90     ~CollationLoader();
91 
92     // All loadFromXXX methods add a reference to the returned value.
93     const CollationCacheEntry *loadFromLocale(UErrorCode &errorCode);
94     const CollationCacheEntry *loadFromBundle(UErrorCode &errorCode);
95     const CollationCacheEntry *loadFromCollations(UErrorCode &errorCode);
96     const CollationCacheEntry *loadFromData(UErrorCode &errorCode);
97 
98     // Adds a reference to returned value.
99     const CollationCacheEntry *getCacheEntry(UErrorCode &errorCode);
100 
101     /**
102      * Returns the rootEntry (with one addRef()) if loc==root,
103      * or else returns a new cache entry with ref count 1 for the loc and
104      * the root tailoring.
105      */
106     const CollationCacheEntry *makeCacheEntryFromRoot(
107             const Locale &loc, UErrorCode &errorCode) const;
108 
109     /**
110      * Returns the entryFromCache as is if loc==validLocale,
111      * or else returns a new cache entry with ref count 1 for the loc and
112      * the same tailoring. In the latter case, a ref count is removed from
113      * entryFromCache.
114      */
115     static const CollationCacheEntry *makeCacheEntry(
116             const Locale &loc,
117             const CollationCacheEntry *entryFromCache,
118             UErrorCode &errorCode);
119 
120     const UnifiedCache *cache;
121     const CollationCacheEntry *rootEntry;
122     Locale validLocale;
123     Locale locale;
124     char type[16];
125     char defaultType[16];
126     uint32_t typesTried;
127     UBool typeFallback;
128     UResourceBundle *bundle;
129     UResourceBundle *collations;
130     UResourceBundle *data;
131 };
132 
133 U_NAMESPACE_END
134 
135 #endif  /* __cplusplus */
136 
137 #endif /* #if !UCONFIG_NO_COLLATION */
138 
139 #endif
140