1 /* 2 ******************************************************************************* 3 * 4 * Copyright (C) 2002-2010, International Business Machines 5 * Corporation and others. All Rights Reserved. 6 * 7 ******************************************************************************* 8 * file name: uprops.h 9 * encoding: US-ASCII 10 * tab size: 8 (not used) 11 * indentation:4 12 * 13 * created on: 2002feb24 14 * created by: Markus W. Scherer 15 * 16 * Constants for mostly non-core Unicode character properties 17 * stored in uprops.icu. 18 */ 19 20 #ifndef __UPROPS_H__ 21 #define __UPROPS_H__ 22 23 #include "unicode/utypes.h" 24 #include "unicode/uset.h" 25 #include "uset_imp.h" 26 #include "udataswp.h" 27 28 /* indexes[] entries */ 29 enum { 30 UPROPS_PROPS32_INDEX, 31 UPROPS_EXCEPTIONS_INDEX, 32 UPROPS_EXCEPTIONS_TOP_INDEX, 33 34 UPROPS_ADDITIONAL_TRIE_INDEX, 35 UPROPS_ADDITIONAL_VECTORS_INDEX, 36 UPROPS_ADDITIONAL_VECTORS_COLUMNS_INDEX, 37 38 UPROPS_SCRIPT_EXTENSIONS_INDEX, 39 40 UPROPS_RESERVED_INDEX_7, 41 UPROPS_RESERVED_INDEX_8, 42 43 /* size of the data file (number of 32-bit units after the header) */ 44 UPROPS_DATA_TOP_INDEX, 45 46 /* maximum values for code values in vector word 0 */ 47 UPROPS_MAX_VALUES_INDEX=10, 48 /* maximum values for code values in vector word 2 */ 49 UPROPS_MAX_VALUES_2_INDEX, 50 51 UPROPS_INDEX_COUNT=16 52 }; 53 54 /* definitions for the main properties words */ 55 enum { 56 /* general category shift==0 0 (5 bits) */ 57 /* reserved 5 (1 bit) */ 58 UPROPS_NUMERIC_TYPE_VALUE_SHIFT=6 /* 6 (10 bits) */ 59 }; 60 61 #define GET_CATEGORY(props) ((props)&0x1f) 62 #define CAT_MASK(props) U_MASK(GET_CATEGORY(props)) 63 64 #define GET_NUMERIC_TYPE_VALUE(props) ((props)>>UPROPS_NUMERIC_TYPE_VALUE_SHIFT) 65 66 /* constants for the storage form of numeric types and values */ 67 enum { 68 UPROPS_NTV_NONE=0, 69 UPROPS_NTV_DECIMAL_START=1, 70 UPROPS_NTV_DIGIT_START=11, 71 UPROPS_NTV_NUMERIC_START=21, 72 UPROPS_NTV_FRACTION_START=0xb0, 73 UPROPS_NTV_LARGE_START=0x1e0, 74 UPROPS_NTV_RESERVED_START=0x300, 75 76 UPROPS_NTV_MAX_SMALL_INT=UPROPS_NTV_FRACTION_START-UPROPS_NTV_NUMERIC_START-1 77 }; 78 79 #define UPROPS_NTV_GET_TYPE(ntv) \ 80 ((ntv==UPROPS_NTV_NONE) ? U_NT_NONE : \ 81 (ntv<UPROPS_NTV_DIGIT_START) ? U_NT_DECIMAL : \ 82 (ntv<UPROPS_NTV_NUMERIC_START) ? U_NT_DIGIT : \ 83 U_NT_NUMERIC) 84 85 /* number of properties vector words */ 86 #define UPROPS_VECTOR_WORDS 3 87 88 /* 89 * Properties in vector word 0 90 * Bits 91 * 31..24 DerivedAge version major/minor one nibble each 92 * 23..22 3..1: Bits 7..0 = Script_Extensions index 93 * 3: Script value from Script_Extensions 94 * 2: Script=Inherited 95 * 1: Script=Common 96 * 0: Script=bits 7..0 97 * 21..20 reserved 98 * 19..17 East Asian Width 99 * 16.. 8 UBlockCode 100 * 7.. 0 UScriptCode, or index to Script_Extensions 101 */ 102 103 /* derived age: one nibble each for major and minor version numbers */ 104 #define UPROPS_AGE_MASK 0xff000000 105 #define UPROPS_AGE_SHIFT 24 106 107 /* Script_Extensions: mask includes Script */ 108 #define UPROPS_SCRIPT_X_MASK 0x00c000ff 109 #define UPROPS_SCRIPT_X_SHIFT 22 110 111 #define UPROPS_EA_MASK 0x000e0000 112 #define UPROPS_EA_SHIFT 17 113 114 #define UPROPS_BLOCK_MASK 0x0001ff00 115 #define UPROPS_BLOCK_SHIFT 8 116 117 #define UPROPS_SCRIPT_MASK 0x000000ff 118 119 /* UPROPS_SCRIPT_X_WITH_COMMON must be the lowest value that involves Script_Extensions. */ 120 #define UPROPS_SCRIPT_X_WITH_COMMON 0x400000 121 #define UPROPS_SCRIPT_X_WITH_INHERITED 0x800000 122 #define UPROPS_SCRIPT_X_WITH_OTHER 0xc00000 123 124 /* 125 * Properties in vector word 1 126 * Each bit encodes one binary property. 127 * The following constants represent the bit number, use 1<<UPROPS_XYZ. 128 * UPROPS_BINARY_1_TOP<=32! 129 * 130 * Keep this list of property enums in sync with 131 * propListNames[] in icu/source/tools/genprops/props2.c! 132 * 133 * ICU 2.6/uprops format version 3.2 stores full properties instead of "Other_". 134 */ 135 enum { 136 UPROPS_WHITE_SPACE, 137 UPROPS_DASH, 138 UPROPS_HYPHEN, 139 UPROPS_QUOTATION_MARK, 140 UPROPS_TERMINAL_PUNCTUATION, 141 UPROPS_MATH, 142 UPROPS_HEX_DIGIT, 143 UPROPS_ASCII_HEX_DIGIT, 144 UPROPS_ALPHABETIC, 145 UPROPS_IDEOGRAPHIC, 146 UPROPS_DIACRITIC, 147 UPROPS_EXTENDER, 148 UPROPS_NONCHARACTER_CODE_POINT, 149 UPROPS_GRAPHEME_EXTEND, 150 UPROPS_GRAPHEME_LINK, 151 UPROPS_IDS_BINARY_OPERATOR, 152 UPROPS_IDS_TRINARY_OPERATOR, 153 UPROPS_RADICAL, 154 UPROPS_UNIFIED_IDEOGRAPH, 155 UPROPS_DEFAULT_IGNORABLE_CODE_POINT, 156 UPROPS_DEPRECATED, 157 UPROPS_LOGICAL_ORDER_EXCEPTION, 158 UPROPS_XID_START, 159 UPROPS_XID_CONTINUE, 160 UPROPS_ID_START, /* ICU 2.6, uprops format version 3.2 */ 161 UPROPS_ID_CONTINUE, 162 UPROPS_GRAPHEME_BASE, 163 UPROPS_S_TERM, /* new in ICU 3.0 and Unicode 4.0.1 */ 164 UPROPS_VARIATION_SELECTOR, 165 UPROPS_PATTERN_SYNTAX, /* new in ICU 3.4 and Unicode 4.1 */ 166 UPROPS_PATTERN_WHITE_SPACE, 167 UPROPS_RESERVED, /* reserved & unused */ 168 UPROPS_BINARY_1_TOP /* ==32 - full! */ 169 }; 170 171 /* 172 * Properties in vector word 2 173 * Bits 174 * 31..26 reserved 175 * 25..20 Line Break 176 * 19..15 Sentence Break 177 * 14..10 Word Break 178 * 9.. 5 Grapheme Cluster Break 179 * 4.. 0 Decomposition Type 180 */ 181 #define UPROPS_LB_MASK 0x03f00000 182 #define UPROPS_LB_SHIFT 20 183 184 #define UPROPS_SB_MASK 0x000f8000 185 #define UPROPS_SB_SHIFT 15 186 187 #define UPROPS_WB_MASK 0x00007c00 188 #define UPROPS_WB_SHIFT 10 189 190 #define UPROPS_GCB_MASK 0x000003e0 191 #define UPROPS_GCB_SHIFT 5 192 193 #define UPROPS_DT_MASK 0x0000001f 194 195 /** 196 * Get a properties vector word for a code point. 197 * Implemented in uchar.c for uprops.c. 198 * column==-1 gets the 32-bit main properties word instead. 199 * @return 0 if no data or illegal argument 200 */ 201 U_CFUNC uint32_t 202 u_getUnicodeProperties(UChar32 c, int32_t column); 203 204 /** 205 * Get the the maximum values for some enum/int properties. 206 * Use the same column numbers as for u_getUnicodeProperties(). 207 * The returned value will contain maximum values stored in the same bit fields 208 * as where the enum values are stored in the u_getUnicodeProperties() 209 * return values for the same columns. 210 * 211 * Valid columns are those for properties words that contain enumerated values. 212 * (ICU 2.6: columns 0 and 2) 213 * For other column numbers, this function will return 0. 214 * 215 * @internal 216 */ 217 U_CFUNC int32_t 218 uprv_getMaxValues(int32_t column); 219 220 /** 221 * Checks if c is alphabetic, or a decimal digit; implements UCHAR_POSIX_ALNUM. 222 * @internal 223 */ 224 U_CFUNC UBool 225 u_isalnumPOSIX(UChar32 c); 226 227 /** 228 * Checks if c is in 229 * [^\p{space}\p{gc=Control}\p{gc=Surrogate}\p{gc=Unassigned}] 230 * with space=\p{Whitespace} and Control=Cc. 231 * Implements UCHAR_POSIX_GRAPH. 232 * @internal 233 */ 234 U_CFUNC UBool 235 u_isgraphPOSIX(UChar32 c); 236 237 /** 238 * Checks if c is in \p{graph}\p{blank} - \p{cntrl}. 239 * Implements UCHAR_POSIX_PRINT. 240 * @internal 241 */ 242 U_CFUNC UBool 243 u_isprintPOSIX(UChar32 c); 244 245 /** Turn a bit index into a bit flag. @internal */ 246 #define FLAG(n) ((uint32_t)1<<(n)) 247 248 /** Flags for general categories in the order of UCharCategory. @internal */ 249 #define _Cn FLAG(U_GENERAL_OTHER_TYPES) 250 #define _Lu FLAG(U_UPPERCASE_LETTER) 251 #define _Ll FLAG(U_LOWERCASE_LETTER) 252 #define _Lt FLAG(U_TITLECASE_LETTER) 253 #define _Lm FLAG(U_MODIFIER_LETTER) 254 /* #define _Lo FLAG(U_OTHER_LETTER) -- conflicts with MS Visual Studio 9.0 xiosbase */ 255 #define _Mn FLAG(U_NON_SPACING_MARK) 256 #define _Me FLAG(U_ENCLOSING_MARK) 257 #define _Mc FLAG(U_COMBINING_SPACING_MARK) 258 #define _Nd FLAG(U_DECIMAL_DIGIT_NUMBER) 259 #define _Nl FLAG(U_LETTER_NUMBER) 260 #define _No FLAG(U_OTHER_NUMBER) 261 #define _Zs FLAG(U_SPACE_SEPARATOR) 262 #define _Zl FLAG(U_LINE_SEPARATOR) 263 #define _Zp FLAG(U_PARAGRAPH_SEPARATOR) 264 #define _Cc FLAG(U_CONTROL_CHAR) 265 #define _Cf FLAG(U_FORMAT_CHAR) 266 #define _Co FLAG(U_PRIVATE_USE_CHAR) 267 #define _Cs FLAG(U_SURROGATE) 268 #define _Pd FLAG(U_DASH_PUNCTUATION) 269 #define _Ps FLAG(U_START_PUNCTUATION) 270 /* #define _Pe FLAG(U_END_PUNCTUATION) -- conflicts with MS Visual Studio 9.0 xlocnum */ 271 /* #define _Pc FLAG(U_CONNECTOR_PUNCTUATION) -- conflicts with MS Visual Studio 9.0 streambuf */ 272 #define _Po FLAG(U_OTHER_PUNCTUATION) 273 #define _Sm FLAG(U_MATH_SYMBOL) 274 #define _Sc FLAG(U_CURRENCY_SYMBOL) 275 #define _Sk FLAG(U_MODIFIER_SYMBOL) 276 #define _So FLAG(U_OTHER_SYMBOL) 277 #define _Pi FLAG(U_INITIAL_PUNCTUATION) 278 /* #define _Pf FLAG(U_FINAL_PUNCTUATION) -- conflicts with MS Visual Studio 9.0 streambuf */ 279 280 /** Some code points. @internal */ 281 enum { 282 TAB =0x0009, 283 LF =0x000a, 284 FF =0x000c, 285 CR =0x000d, 286 U_A =0x0041, 287 U_F =0x0046, 288 U_Z =0x005a, 289 U_a =0x0061, 290 U_f =0x0066, 291 U_z =0x007a, 292 DEL =0x007f, 293 NL =0x0085, 294 NBSP =0x00a0, 295 CGJ =0x034f, 296 FIGURESP=0x2007, 297 HAIRSP =0x200a, 298 ZWNJ =0x200c, 299 ZWJ =0x200d, 300 RLM =0x200f, 301 NNBSP =0x202f, 302 WJ =0x2060, 303 INHSWAP =0x206a, 304 NOMDIG =0x206f, 305 U_FW_A =0xff21, 306 U_FW_F =0xff26, 307 U_FW_Z =0xff3a, 308 U_FW_a =0xff41, 309 U_FW_f =0xff46, 310 U_FW_z =0xff5a, 311 ZWNBSP =0xfeff 312 }; 313 314 /** 315 * Get the maximum length of a (regular/1.0/extended) character name. 316 * @return 0 if no character names available. 317 */ 318 U_CAPI int32_t U_EXPORT2 319 uprv_getMaxCharNameLength(void); 320 321 /** 322 * Fills set with characters that are used in Unicode character names. 323 * Includes all characters that are used in regular/Unicode 1.0/extended names. 324 * Just empties the set if no character names are available. 325 * @param sa USetAdder to receive characters. 326 */ 327 U_CAPI void U_EXPORT2 328 uprv_getCharNameCharacters(const USetAdder *sa); 329 330 /** 331 * Constants for which data and implementation files provide which properties. 332 * Used by UnicodeSet for service-specific property enumeration. 333 * @internal 334 */ 335 enum UPropertySource { 336 /** No source, not a supported property. */ 337 UPROPS_SRC_NONE, 338 /** From uchar.c/uprops.icu main trie */ 339 UPROPS_SRC_CHAR, 340 /** From uchar.c/uprops.icu properties vectors trie */ 341 UPROPS_SRC_PROPSVEC, 342 /** From unames.c/unames.icu */ 343 UPROPS_SRC_NAMES, 344 /** From ucase.c/ucase.icu */ 345 UPROPS_SRC_CASE, 346 /** From ubidi_props.c/ubidi.icu */ 347 UPROPS_SRC_BIDI, 348 /** From uchar.c/uprops.icu main trie as well as properties vectors trie */ 349 UPROPS_SRC_CHAR_AND_PROPSVEC, 350 /** From ucase.c/ucase.icu as well as unorm.cpp/unorm.icu */ 351 UPROPS_SRC_CASE_AND_NORM, 352 /** From normalizer2impl.cpp/nfc.nrm */ 353 UPROPS_SRC_NFC, 354 /** From normalizer2impl.cpp/nfkc.nrm */ 355 UPROPS_SRC_NFKC, 356 /** From normalizer2impl.cpp/nfkc_cf.nrm */ 357 UPROPS_SRC_NFKC_CF, 358 /** From normalizer2impl.cpp/nfc.nrm canonical iterator data */ 359 UPROPS_SRC_NFC_CANON_ITER, 360 /** One more than the highest UPropertySource (UPROPS_SRC_) constant. */ 361 UPROPS_SRC_COUNT 362 }; 363 typedef enum UPropertySource UPropertySource; 364 365 /** 366 * @see UPropertySource 367 * @internal 368 */ 369 U_CFUNC UPropertySource U_EXPORT2 370 uprops_getSource(UProperty which); 371 372 /** 373 * Enumerate uprops.icu's main data trie and add the 374 * start of each range of same properties to the set. 375 * @internal 376 */ 377 U_CFUNC void U_EXPORT2 378 uchar_addPropertyStarts(const USetAdder *sa, UErrorCode *pErrorCode); 379 380 /** 381 * Enumerate uprops.icu's properties vectors trie and add the 382 * start of each range of same properties to the set. 383 * @internal 384 */ 385 U_CFUNC void U_EXPORT2 386 upropsvec_addPropertyStarts(const USetAdder *sa, UErrorCode *pErrorCode); 387 388 /** 389 * Return a set of characters for property enumeration. 390 * For each two consecutive characters (start, limit) in the set, 391 * all of the properties for start..limit-1 are all the same. 392 * 393 * @param sa USetAdder to receive result. Existing contents are lost. 394 * @internal 395 */ 396 /*U_CFUNC void U_EXPORT2 397 uprv_getInclusions(const USetAdder *sa, UErrorCode *pErrorCode); 398 */ 399 400 /** 401 * Swap the ICU Unicode properties file. See uchar.c. 402 * @internal 403 */ 404 U_CAPI int32_t U_EXPORT2 405 uprops_swap(const UDataSwapper *ds, 406 const void *inData, int32_t length, void *outData, 407 UErrorCode *pErrorCode); 408 409 /** 410 * Swap the ICU Unicode character names file. See uchar.c. 411 * @internal 412 */ 413 U_CAPI int32_t U_EXPORT2 414 uchar_swapNames(const UDataSwapper *ds, 415 const void *inData, int32_t length, void *outData, 416 UErrorCode *pErrorCode); 417 418 #ifdef XP_CPLUSPLUS 419 420 U_NAMESPACE_BEGIN 421 422 class UnicodeSet; 423 424 // implemented in uniset_props.cpp 425 U_CFUNC UnicodeSet * 426 uniset_getUnicode32Instance(UErrorCode &errorCode); 427 428 U_NAMESPACE_END 429 430 #endif 431 432 #endif 433