/* ********************************************************************** * Copyright (C) 1997-2001, International Business Machines * Corporation and others. All Rights Reserved. ********************************************************************** * * File UCHAR.H * * Modification History: * * Date Name Description * 04/02/97 aliu Creation. * 03/29/99 helena Updated for C APIs. * 4/15/99 Madhu Updated for C Implementation and Javadoc * 5/20/99 Madhu Added the function u_getVersion() * 8/19/1999 srl Upgraded scripts to Unicode 3.0 * 8/27/1999 schererm UCharDirection constants: U_... * 11/11/1999 weiv added u_isalnum(), cleaned comments * 01/11/2000 helena Renamed u_getVersion to u_getUnicodeVersion(). ****************************************************************************** */ #ifndef UCHAR_H #define UCHAR_H #include "unicode/utypes.h" U_CDECL_BEGIN /*==========================================================================*/ /* Unicode version number */ /*==========================================================================*/ /** * Unicode version number, default for the current ICU version. * The actual Unicode Character Database (UCD) data is stored in uprops.dat * and may be generated from UCD files from a different Unicode version. * Call u_getUnicodeVersion to get the actual Unicode version of the data. * * @see u_getUnicodeVersion * @stable */ #define U_UNICODE_VERSION "3.2" /** * \file * \brief C API: Unicode Char * *

Unicode C API

* The Unicode C API allows you to query the properties associated with individual * Unicode character values. *

* The Unicode character information, provided implicitly by the * Unicode character encoding standard, includes information about the script * (for example, symbols or control characters) to which the character belongs, * as well as semantic information such as whether a character is a digit or * uppercase, lowercase, or uncased. *

*/ /** * Constants. */ /** The lowest Unicode code point value. Code points are non-negative. @stable */ #define UCHAR_MIN_VALUE 0 /** * The highest Unicode code point value (scalar value) according to * The Unicode Standard. This is a 21-bit value (20.1 bits, rounded up). * For a single character, UChar32 is a simple type that can hold any code point value. * @stable */ #define UCHAR_MAX_VALUE 0x10ffff /** * Get a single-bit bit set (a flag) from a bit number 0..31. * @draft ICU 2.1 */ #define U_MASK(x) ((uint32_t)1<<(x)) /** * Selection constants for Unicode properties. * These constants are used in functions like u_hasBinaryProperty to select * one of the Unicode properties. * * The properties APIs are intended to reflect Unicode properties as defined * in the Unicode Character Database (UCD) and Unicode Technical Reports (UTR). * For details about the properties see http://www.unicode.org/ . * For names of Unicode properties see the UCD file PropertyAliases.txt. * * Important: If ICU is built with UCD files from Unicode versions below 3.2, * then properties marked with "new in Unicode 3.2" are not or not fully available. * Check u_getUnicodeVersion to be sure. * * @see u_hasBinaryProperty * @see u_getIntPropertyValue * @see u_getUnicodeVersion * @draft ICU 2.1 */ enum UProperty { /** Binary property Alphabetic. Same as u_isUAlphabetic, different from u_isalpha. Lu+Ll+Lt+Lm+Lo+Nl+Other_Alphabetic @draft ICU 2.1 */ UCHAR_ALPHABETIC, /** First constant for binary Unicode properties. @draft ICU 2.1 */ UCHAR_BINARY_START=UCHAR_ALPHABETIC, /** Binary property ASCII_Hex_Digit. 0-9 A-F a-f @draft ICU 2.1 */ UCHAR_ASCII_HEX_DIGIT, /** Binary property Bidi_Control. Format controls which have specific functions in the Bidi Algorithm. @draft ICU 2.1 */ UCHAR_BIDI_CONTROL, /** Binary property Bidi_Mirrored. Characters that may change display in RTL text. Same as u_isMirrored. See Bidi Algorithm, UTR 9. @draft ICU 2.1 */ UCHAR_BIDI_MIRRORED, /** Binary property Dash. Variations of dashes. @draft ICU 2.1 */ UCHAR_DASH, /** Binary property Default_Ignorable_Code_Point (new in Unicode 3.2). Ignorable in most processing. <2060..206F, FFF0..FFFB, E0000..E0FFF>+Other_Default_Ignorable_Code_Point+(Cf+Cc+Cs-White_Space) @draft ICU 2.1 */ UCHAR_DEFAULT_IGNORABLE_CODE_POINT, /** Binary property Deprecated (new in Unicode 3.2). The usage of deprecated characters is strongly discouraged. @draft ICU 2.1 */ UCHAR_DEPRECATED, /** Binary property Diacritic. Characters that linguistically modify the meaning of another character to which they apply. @draft ICU 2.1 */ UCHAR_DIACRITIC, /** Binary property Extender. Extend the value or shape of a preceding alphabetic character, e.g., length and iteration marks. @draft ICU 2.1 */ UCHAR_EXTENDER, /** Binary property Full_Composition_Exclusion. CompositionExclusions.txt+Singleton Decompositions+ Non-Starter Decompositions. @draft ICU 2.1 */ UCHAR_FULL_COMPOSITION_EXCLUSION, /** Binary property Grapheme_Base (new in Unicode 3.2). For programmatic determination of grapheme cluster boundaries. [0..10FFFF]-Cc-Cf-Cs-Co-Cn-Zl-Zp-Grapheme_Link-Grapheme_Extend-CGJ @draft ICU 2.1 */ UCHAR_GRAPHEME_BASE, /** Binary property Grapheme_Extend (new in Unicode 3.2). For programmatic determination of grapheme cluster boundaries. Me+Mn+Mc+Other_Grapheme_Extend-Grapheme_Link-CGJ @draft ICU 2.1 */ UCHAR_GRAPHEME_EXTEND, /** Binary property Grapheme_Link (new in Unicode 3.2). For programmatic determination of grapheme cluster boundaries. @draft ICU 2.1 */ UCHAR_GRAPHEME_LINK, /** Binary property Hex_Digit. Characters commonly used for hexadecimal numbers. @draft ICU 2.1 */ UCHAR_HEX_DIGIT, /** Binary property Hyphen. Dashes used to mark connections between pieces of words, plus the Katakana middle dot. @draft ICU 2.1 */ UCHAR_HYPHEN, /** Binary property ID_Continue. Characters that can continue an identifier. ID_Start+Mn+Mc+Nd+Pc @draft ICU 2.1 */ UCHAR_ID_CONTINUE, /** Binary property ID_Start. Characters that can start an identifier. Lu+Ll+Lt+Lm+Lo+Nl @draft ICU 2.1 */ UCHAR_ID_START, /** Binary property Ideographic. CJKV ideographs. @draft ICU 2.1 */ UCHAR_IDEOGRAPHIC, /** Binary property IDS_Binary_Operator (new in Unicode 3.2). For programmatic determination of Ideographic Description Sequences. @draft ICU 2.1 */ UCHAR_IDS_BINARY_OPERATOR, /** Binary property IDS_Trinary_Operator (new in Unicode 3.2). For programmatic determination of Ideographic Description Sequences. @draft ICU 2.1 */ UCHAR_IDS_TRINARY_OPERATOR, /** Binary property Join_Control. Format controls for cursive joining and ligation. @draft ICU 2.1 */ UCHAR_JOIN_CONTROL, /** Binary property Logical_Order_Exception (new in Unicode 3.2). Characters that do not use logical order and require special handling in most processing. @draft ICU 2.1 */ UCHAR_LOGICAL_ORDER_EXCEPTION, /** Binary property Lowercase. Same as u_isULowercase, different from u_islower. Ll+Other_Lowercase @draft ICU 2.1 */ UCHAR_LOWERCASE, /** Binary property Math. Sm+Other_Math @draft ICU 2.1 */ UCHAR_MATH, /** Binary property Noncharacter_Code_Point. Code points that are explicitly defined as illegal for the encoding of characters. @draft ICU 2.1 */ UCHAR_NONCHARACTER_CODE_POINT, /** Binary property Quotation_Mark. @draft ICU 2.1 */ UCHAR_QUOTATION_MARK, /** Binary property Radical (new in Unicode 3.2). For programmatic determination of Ideographic Description Sequences. @draft ICU 2.1 */ UCHAR_RADICAL, /** Binary property Soft_Dotted (new in Unicode 3.2). Characters with a "soft dot", like i or j. An accent placed on these characters causes the dot to disappear. @draft ICU 2.1 */ UCHAR_SOFT_DOTTED, /** Binary property Terminal_Punctuation. Punctuation characters that generally mark the end of textual units. @draft ICU 2.1 */ UCHAR_TERMINAL_PUNCTUATION, /** Binary property Unified_Ideograph (new in Unicode 3.2). For programmatic determination of Ideographic Description Sequences. @draft ICU 2.1 */ UCHAR_UNIFIED_IDEOGRAPH, /** Binary property Uppercase. Same as u_isUUppercase, different from u_isupper. Lu+Other_Uppercase @draft ICU 2.1 */ UCHAR_UPPERCASE, /** Binary property White_Space. Same as u_isUWhiteSpace, different from u_isspace and u_isWhitespace. Space characters+TAB+CR+LF-ZWSP-ZWNBSP @draft ICU 2.1 */ UCHAR_WHITE_SPACE, /** Binary property XID_Continue. ID_Continue modified to allow closure under normalization forms NFKC and NFKD. @draft ICU 2.1 */ UCHAR_XID_CONTINUE, /** Binary property XID_Start. ID_Start modified to allow closure under normalization forms NFKC and NFKD. @draft ICU 2.1 */ UCHAR_XID_START, /** One more than the last constant for binary Unicode properties. @draft ICU 2.1 */ UCHAR_BINARY_LIMIT, /** Enumerated property Bidi_Class. Same as u_charDirection, returns UCharDirection values. @draft ICU 2.2 */ UCHAR_BIDI_CLASS=0x1000, /** First constant for enumerated/integer Unicode properties. @draft ICU 2.2 */ UCHAR_INT_START=UCHAR_BIDI_CLASS, /** Enumerated property Block. Same as ublock_getCode, returns UBlockCode values. @draft ICU 2.2 */ UCHAR_BLOCK, /** Enumerated property Canonical_Combining_Class. Same as u_getCombiningClass, returns 8-bit numeric values. @draft ICU 2.2 */ UCHAR_CANONICAL_COMBINING_CLASS, /** Enumerated property Decomposition_Type. Returns UDecompositionType values. @draft ICU 2.2 */ UCHAR_DECOMPOSITION_TYPE, /** Enumerated property East_Asian_Width. See http://www.unicode.org/reports/tr11/ Returns UEastAsianWidth values. @draft ICU 2.2 */ UCHAR_EAST_ASIAN_WIDTH, /** Enumerated property General_Category. Same as u_charType, returns UCharCategory values. @draft ICU 2.2 */ UCHAR_GENERAL_CATEGORY, /** Enumerated property Joining_Group. Returns UJoiningGroup values. @draft ICU 2.2 */ UCHAR_JOINING_GROUP, /** Enumerated property Joining_Type. Returns UJoiningType values. @draft ICU 2.2 */ UCHAR_JOINING_TYPE, /** Enumerated property Line_Break. Returns ULineBreak values. @draft ICU 2.2 */ UCHAR_LINE_BREAK, /** Enumerated property Numeric_Type. Returns UNumericType values. @draft ICU 2.2 */ UCHAR_NUMERIC_TYPE, /** Enumerated property Script. Same as uscript_getScript, returns UScriptCode values. @draft ICU 2.2 */ UCHAR_SCRIPT, /** One more than the last constant for enumerated/integer Unicode properties. @draft ICU 2.2 */ UCHAR_INT_LIMIT }; /** @draft ICU 2.1 */ typedef enum UProperty UProperty; /** * Data for enumerated Unicode general category types. * See http://www.unicode.org/Public/UNIDATA/UnicodeData.html . * @stable */ enum UCharCategory { /** Non-category for unassigned and non-character code points. @stable */ U_UNASSIGNED = 0, /** Cn "Other, Not Assigned (no characters in [UnicodeData.txt] have this property)" (same as U_UNASSIGNED!) @draft ICU 2.0 */ U_GENERAL_OTHER_TYPES = 0, /** Lu @stable */ U_UPPERCASE_LETTER = 1, /** Ll @stable */ U_LOWERCASE_LETTER = 2, /** Lt @stable */ U_TITLECASE_LETTER = 3, /** Lm @stable */ U_MODIFIER_LETTER = 4, /** Lo @stable */ U_OTHER_LETTER = 5, /** Mn @stable */ U_NON_SPACING_MARK = 6, /** Me @stable */ U_ENCLOSING_MARK = 7, /** Mc @stable */ U_COMBINING_SPACING_MARK = 8, /** Nd @stable */ U_DECIMAL_DIGIT_NUMBER = 9, /** Nl @stable */ U_LETTER_NUMBER = 10, /** No @stable */ U_OTHER_NUMBER = 11, /** Zs @stable */ U_SPACE_SEPARATOR = 12, /** Zl @stable */ U_LINE_SEPARATOR = 13, /** Zp @stable */ U_PARAGRAPH_SEPARATOR = 14, /** Cc @stable */ U_CONTROL_CHAR = 15, /** Cf @stable */ U_FORMAT_CHAR = 16, /** Co @stable */ U_PRIVATE_USE_CHAR = 17, /** Cs @stable */ U_SURROGATE = 18, /** Pd @stable */ U_DASH_PUNCTUATION = 19, /** Ps @stable */ U_START_PUNCTUATION = 20, /** Pe @stable */ U_END_PUNCTUATION = 21, /** Pc @stable */ U_CONNECTOR_PUNCTUATION = 22, /** Po @stable */ U_OTHER_PUNCTUATION = 23, /** Sm @stable */ U_MATH_SYMBOL = 24, /** Sc @stable */ U_CURRENCY_SYMBOL = 25, /** Sk @stable */ U_MODIFIER_SYMBOL = 26, /** So @stable */ U_OTHER_SYMBOL = 27, /** Pi @stable */ U_INITIAL_PUNCTUATION = 28, /** Pf @stable */ U_FINAL_PUNCTUATION = 29, /** One higher than the last enum UCharCategory constant. @stable */ U_CHAR_CATEGORY_COUNT }; typedef enum UCharCategory UCharCategory; /** * U_GC_XX_MASK constants are bit flags corresponding to Unicode * general category values. * For each category, the nth bit is set if the numeric value of the * corresponding UCharCategory constant is n. * * There are also some U_GC_Y_MASK constants for groups of general categories * like L& for all letter categories. * * @see u_charType * @see U_GET_GC_MASK * @see UCharCategory * @draft ICU 2.1 */ #define U_GC_CN_MASK U_MASK(U_GENERAL_OTHER_TYPES) #define U_GC_LU_MASK U_MASK(U_UPPERCASE_LETTER) #define U_GC_LL_MASK U_MASK(U_LOWERCASE_LETTER) #define U_GC_LT_MASK U_MASK(U_TITLECASE_LETTER) #define U_GC_LM_MASK U_MASK(U_MODIFIER_LETTER) #define U_GC_LO_MASK U_MASK(U_OTHER_LETTER) #define U_GC_MN_MASK U_MASK(U_NON_SPACING_MARK) #define U_GC_ME_MASK U_MASK(U_ENCLOSING_MARK) #define U_GC_MC_MASK U_MASK(U_COMBINING_SPACING_MARK) #define U_GC_ND_MASK U_MASK(U_DECIMAL_DIGIT_NUMBER) #define U_GC_NL_MASK U_MASK(U_LETTER_NUMBER) #define U_GC_NO_MASK U_MASK(U_OTHER_NUMBER) #define U_GC_ZS_MASK U_MASK(U_SPACE_SEPARATOR) #define U_GC_ZL_MASK U_MASK(U_LINE_SEPARATOR) #define U_GC_ZP_MASK U_MASK(U_PARAGRAPH_SEPARATOR) #define U_GC_CC_MASK U_MASK(U_CONTROL_CHAR) #define U_GC_CF_MASK U_MASK(U_FORMAT_CHAR) #define U_GC_CO_MASK U_MASK(U_PRIVATE_USE_CHAR) #define U_GC_CS_MASK U_MASK(U_SURROGATE) #define U_GC_PD_MASK U_MASK(U_DASH_PUNCTUATION) #define U_GC_PS_MASK U_MASK(U_START_PUNCTUATION) #define U_GC_PE_MASK U_MASK(U_END_PUNCTUATION) #define U_GC_PC_MASK U_MASK(U_CONNECTOR_PUNCTUATION) #define U_GC_PO_MASK U_MASK(U_OTHER_PUNCTUATION) #define U_GC_SM_MASK U_MASK(U_MATH_SYMBOL) #define U_GC_SC_MASK U_MASK(U_CURRENCY_SYMBOL) #define U_GC_SK_MASK U_MASK(U_MODIFIER_SYMBOL) #define U_GC_SO_MASK U_MASK(U_OTHER_SYMBOL) #define U_GC_PI_MASK U_MASK(U_INITIAL_PUNCTUATION) #define U_GC_PF_MASK U_MASK(U_FINAL_PUNCTUATION) #define U_GC_L_MASK \ (U_GC_LU_MASK|U_GC_LL_MASK|U_GC_LT_MASK|U_GC_LM_MASK|U_GC_LO_MASK) #define U_GC_M_MASK (U_GC_MN_MASK|U_GC_ME_MASK|U_GC_MC_MASK) #define U_GC_N_MASK (U_GC_ND_MASK|U_GC_NL_MASK|U_GC_NO_MASK) #define U_GC_Z_MASK (U_GC_ZS_MASK|U_GC_ZL_MASK|U_GC_ZP_MASK) #define U_GC_C_MASK \ (U_GC_CN_MASK|U_GC_CC_MASK|U_GC_CF_MASK|U_GC_CO_MASK|U_GC_CS_MASK) #define U_GC_P_MASK \ (U_GC_PD_MASK|U_GC_PS_MASK|U_GC_PE_MASK|U_GC_PC_MASK|U_GC_PO_MASK| \ U_GC_PI_MASK|U_GC_PF_MASK) #define U_GC_S_MASK (U_GC_SM_MASK|U_GC_SC_MASK|U_GC_SK_MASK|U_GC_SO_MASK) /** * This specifies the language directional property of a character set. * @stable */ enum UCharDirection { /** L @stable */ U_LEFT_TO_RIGHT = 0, /** R @stable */ U_RIGHT_TO_LEFT = 1, /** EN @stable */ U_EUROPEAN_NUMBER = 2, /** ES @stable */ U_EUROPEAN_NUMBER_SEPARATOR = 3, /** ET @stable */ U_EUROPEAN_NUMBER_TERMINATOR = 4, /** AN @stable */ U_ARABIC_NUMBER = 5, /** CS @stable */ U_COMMON_NUMBER_SEPARATOR = 6, /** B @stable */ U_BLOCK_SEPARATOR = 7, /** S @stable */ U_SEGMENT_SEPARATOR = 8, /** WS @stable */ U_WHITE_SPACE_NEUTRAL = 9, /** ON @stable */ U_OTHER_NEUTRAL = 10, /** LRE @stable */ U_LEFT_TO_RIGHT_EMBEDDING = 11, /** LRO @stable */ U_LEFT_TO_RIGHT_OVERRIDE = 12, /** AL @stable */ U_RIGHT_TO_LEFT_ARABIC = 13, /** RLE @stable */ U_RIGHT_TO_LEFT_EMBEDDING = 14, /** RLO @stable */ U_RIGHT_TO_LEFT_OVERRIDE = 15, /** PDF @stable */ U_POP_DIRECTIONAL_FORMAT = 16, /** NSM @stable */ U_DIR_NON_SPACING_MARK = 17, /** BN @stable */ U_BOUNDARY_NEUTRAL = 18, /** @stable */ U_CHAR_DIRECTION_COUNT }; typedef enum UCharDirection UCharDirection; /** * Constants for Unicode blocks, generated from Unicode Data file Blocks.txt * These are the same values as Unicode::EUnicodeScript * @draft ICU 2.0 */ enum UBlockCode { /** @draft ICU 2.0 */ UBLOCK_BASIC_LATIN = 1, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_BASIC_LATIN = 1, /** @draft ICU 2.0 */ UBLOCK_LATIN_1_SUPPLEMENT=2, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_LATIN_1_SUPPLEMENT=2, /** @draft ICU 2.0 */ UBLOCK_LATIN_EXTENDED_A =3, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_LATIN_EXTENDED_A=3, /** @draft ICU 2.0 */ UBLOCK_LATIN_EXTENDED_B =4, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_LATIN_EXTENDED_B=4, /** @draft ICU 2.0 */ UBLOCK_IPA_EXTENSIONS =5, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_IPA_EXTENSIONS=5, /** @draft ICU 2.0 */ UBLOCK_SPACING_MODIFIER_LETTERS =6, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_SPACING_MODIFIER_LETTERS=6, /** @draft ICU 2.0 */ UBLOCK_COMBINING_DIACRITICAL_MARKS =7, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_COMBINING_DIACRITICAL_MARKS=7, /** * Unicode 3.2 renames this block to "Greek and Coptic". * @draft ICU 2.0 */ UBLOCK_GREEK =8, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_GREEK=8, /** @draft ICU 2.0 */ UBLOCK_CYRILLIC =9, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CYRILLIC=9, /** @draft ICU 2.0 */ UBLOCK_ARMENIAN =10, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ARMENIAN=10, /** @draft ICU 2.0 */ UBLOCK_HEBREW =11, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_HEBREW=11, /** @draft ICU 2.0 */ UBLOCK_ARABIC =12, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ARABIC=12, /** @draft ICU 2.0 */ UBLOCK_SYRIAC =13, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_SYRIAC=13, /** @draft ICU 2.0 */ UBLOCK_THAANA =14, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_THAANA=14, /** @draft ICU 2.0 */ UBLOCK_DEVANAGARI =15, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_DEVANAGARI=15, /** @draft ICU 2.0 */ UBLOCK_BENGALI =16, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_BENGALI=16, /** @draft ICU 2.0 */ UBLOCK_GURMUKHI =17, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_GURMUKHI=17, /** @draft ICU 2.0 */ UBLOCK_GUJARATI =18, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_GUJARATI=18, /** @draft ICU 2.0 */ UBLOCK_ORIYA =19, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ORIYA=19, /** @draft ICU 2.0 */ UBLOCK_TAMIL =20, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_TAMIL=20, /** @draft ICU 2.0 */ UBLOCK_TELUGU =21, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_TELUGU=21, /** @draft ICU 2.0 */ UBLOCK_KANNADA =22, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_KANNADA=22, /** @draft ICU 2.0 */ UBLOCK_MALAYALAM =23, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_MALAYALAM=23, /** @draft ICU 2.0 */ UBLOCK_SINHALA =24, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_SINHALA=24, /** @draft ICU 2.0 */ UBLOCK_THAI =25, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_THAI=25, /** @draft ICU 2.0 */ UBLOCK_LAO =26, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_LAO=26, /** @draft ICU 2.0 */ UBLOCK_TIBETAN =27, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_TIBETAN=27, /** @draft ICU 2.0 */ UBLOCK_MYANMAR =28, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_MYANMAR=28, /** @draft ICU 2.0 */ UBLOCK_GEORGIAN =29, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_GEORGIAN=29, /** @draft ICU 2.0 */ UBLOCK_HANGUL_JAMO =30, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_HANGUL_JAMO=30, /** @draft ICU 2.0 */ UBLOCK_ETHIOPIC =31, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ETHIOPIC=31, /** @draft ICU 2.0 */ UBLOCK_CHEROKEE =32, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CHEROKEE=32, /** @draft ICU 2.0 */ UBLOCK_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS =33, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS=33, /** @draft ICU 2.0 */ UBLOCK_OGHAM =34, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_OGHAM=34, /** @draft ICU 2.0 */ UBLOCK_RUNIC =35, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_RUNIC=35, /** @draft ICU 2.0 */ UBLOCK_KHMER =36, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_KHMER=36, /** @draft ICU 2.0 */ UBLOCK_MONGOLIAN =37, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_MONGOLIAN=37, /** @draft ICU 2.0 */ UBLOCK_LATIN_EXTENDED_ADDITIONAL =38, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_LATIN_EXTENDED_ADDITIONAL=38, /** @draft ICU 2.0 */ UBLOCK_GREEK_EXTENDED =39, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_GREEK_EXTENDED=39, /** @draft ICU 2.0 */ UBLOCK_GENERAL_PUNCTUATION =40, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_GENERAL_PUNCTUATION=40, /** @draft ICU 2.0 */ UBLOCK_SUPERSCRIPTS_AND_SUBSCRIPTS =41, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_SUPERSCRIPTS_AND_SUBSCRIPTS=41, /** @draft ICU 2.0 */ UBLOCK_CURRENCY_SYMBOLS =42, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CURRENCY_SYMBOLS=42, /** * Unicode 3.2 renames this block to "Combining Diacritical Marks for Symbols". * @draft ICU 2.0 */ UBLOCK_COMBINING_MARKS_FOR_SYMBOLS =43, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_COMBINING_MARKS_FOR_SYMBOLS=43, /** @draft ICU 2.0 */ UBLOCK_LETTERLIKE_SYMBOLS =44, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_LETTERLIKE_SYMBOLS=44, /** @draft ICU 2.0 */ UBLOCK_NUMBER_FORMS =45, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_NUMBER_FORMS=45, /** @draft ICU 2.0 */ UBLOCK_ARROWS =46, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ARROWS=46, /** @draft ICU 2.0 */ UBLOCK_MATHEMATICAL_OPERATORS =47, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_MATHEMATICAL_OPERATORS=47, /** @draft ICU 2.0 */ UBLOCK_MISCELLANEOUS_TECHNICAL =48, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_MISCELLANEOUS_TECHNICAL=48, /** @draft ICU 2.0 */ UBLOCK_CONTROL_PICTURES =49, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CONTROL_PICTURES=49, /** @draft ICU 2.0 */ UBLOCK_OPTICAL_CHARACTER_RECOGNITION =50, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_OPTICAL_CHARACTER_RECOGNITION=50, /** @draft ICU 2.0 */ UBLOCK_ENCLOSED_ALPHANUMERICS =51, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ENCLOSED_ALPHANUMERICS=51, /** @draft ICU 2.0 */ UBLOCK_BOX_DRAWING =52, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_BOX_DRAWING=52, /** @draft ICU 2.0 */ UBLOCK_BLOCK_ELEMENTS =53, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_BLOCK_ELEMENTS=53, /** @draft ICU 2.0 */ UBLOCK_GEOMETRIC_SHAPES =54, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_GEOMETRIC_SHAPES=54, /** @draft ICU 2.0 */ UBLOCK_MISCELLANEOUS_SYMBOLS =55, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_MISCELLANEOUS_SYMBOLS=55, /** @draft ICU 2.0 */ UBLOCK_DINGBATS =56, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_DINGBATS=56, /** @draft ICU 2.0 */ UBLOCK_BRAILLE_PATTERNS =57, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_BRAILLE_PATTERNS=57, /** @draft ICU 2.0 */ UBLOCK_CJK_RADICALS_SUPPLEMENT =58, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CJK_RADICALS_SUPPLEMENT=58, /** @draft ICU 2.0 */ UBLOCK_KANGXI_RADICALS =59, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_KANGXI_RADICALS=59, /** @draft ICU 2.0 */ UBLOCK_IDEOGRAPHIC_DESCRIPTION_CHARACTERS =60, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_IDEOGRAPHIC_DESCRIPTION_CHARACTERS=60, /** @draft ICU 2.0 */ UBLOCK_CJK_SYMBOLS_AND_PUNCTUATION =61, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CJK_SYMBOLS_AND_PUNCTUATION=61, /** @draft ICU 2.0 */ UBLOCK_HIRAGANA =62, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_HIRAGANA=62, /** @draft ICU 2.0 */ UBLOCK_KATAKANA =63, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_KATAKANA=63, /** @draft ICU 2.0 */ UBLOCK_BOPOMOFO =64, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_BOPOMOFO=64, /** @draft ICU 2.0 */ UBLOCK_HANGUL_COMPATIBILITY_JAMO =65, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_HANGUL_COMPATIBILITY_JAMO=65, /** @draft ICU 2.0 */ UBLOCK_KANBUN =66, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_KANBUN=66, /** @draft ICU 2.0 */ UBLOCK_BOPOMOFO_EXTENDED =67, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_BOPOMOFO_EXTENDED=67, /** @draft ICU 2.0 */ UBLOCK_ENCLOSED_CJK_LETTERS_AND_MONTHS =68, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ENCLOSED_CJK_LETTERS_AND_MONTHS=68, /** @draft ICU 2.0 */ UBLOCK_CJK_COMPATIBILITY =69, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CJK_COMPATIBILITY=69, /** @draft ICU 2.0 */ UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A =70, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A=70, /** @draft ICU 2.0 */ UBLOCK_CJK_UNIFIED_IDEOGRAPHS =71, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CJK_UNIFIED_IDEOGRAPHS=71, /** @draft ICU 2.0 */ UBLOCK_YI_SYLLABLES =72, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_YI_SYLLABLES=72, /** @draft ICU 2.0 */ UBLOCK_YI_RADICALS =73, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_YI_RADICALS=73, /** @draft ICU 2.0 */ UBLOCK_HANGUL_SYLLABLES =74, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_HANGUL_SYLLABLES=74, /** @draft ICU 2.0 */ UBLOCK_HIGH_SURROGATES =75, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_HIGH_SURROGATES=75, /** @draft ICU 2.0 */ UBLOCK_HIGH_PRIVATE_USE_SURROGATES =76, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_HIGH_PRIVATE_USE_SURROGATES=76, /** @draft ICU 2.0 */ UBLOCK_LOW_SURROGATES =77, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_LOW_SURROGATES=77, /** * Unicode 3.2 renames this block to "Private Use Area". * @draft ICU 2.0 */ UBLOCK_PRIVATE_USE = 78, /** @deprecated Use UBLOCK_PRIVATE_USE. Remove after Aug, 2002 */ UBLOCK_PRIVATE_USE_AREA =UBLOCK_PRIVATE_USE, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_PRIVATE_USE_AREA=78, /** @draft ICU 2.0 */ UBLOCK_CJK_COMPATIBILITY_IDEOGRAPHS =79, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CJK_COMPATIBILITY_IDEOGRAPHS=79, /** @draft ICU 2.0 */ UBLOCK_ALPHABETIC_PRESENTATION_FORMS =80, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ALPHABETIC_PRESENTATION_FORMS=80, /** @draft ICU 2.0 */ UBLOCK_ARABIC_PRESENTATION_FORMS_A =81, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ARABIC_PRESENTATION_FORMS_A=81, /** @draft ICU 2.0 */ UBLOCK_COMBINING_HALF_MARKS =82, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_COMBINING_HALF_MARKS=82, /** @draft ICU 2.0 */ UBLOCK_CJK_COMPATIBILITY_FORMS =83, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CJK_COMPATIBILITY_FORMS=83, /** @draft ICU 2.0 */ UBLOCK_SMALL_FORM_VARIANTS =84, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_SMALL_FORM_VARIANTS=84, /** @draft ICU 2.0 */ UBLOCK_ARABIC_PRESENTATION_FORMS_B =85, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_ARABIC_PRESENTATION_FORMS_B=85, /** @draft ICU 2.0 */ UBLOCK_SPECIALS =86, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_SPECIALS=86, /** @draft ICU 2.0 */ UBLOCK_HALFWIDTH_AND_FULLWIDTH_FORMS =87, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_HALFWIDTH_AND_FULLWIDTH_FORMS=87, /** @draft ICU 2.0 */ UBLOCK_OLD_ITALIC = 88 , /** @draft ICU 2.0 */ UBLOCK_GOTHIC = 89 , /** @draft ICU 2.0 */ UBLOCK_DESERET = 90 , /** @draft ICU 2.0 */ UBLOCK_BYZANTINE_MUSICAL_SYMBOLS = 91 , /** @draft ICU 2.0 */ UBLOCK_MUSICAL_SYMBOLS = 92 , /** @draft ICU 2.0 */ UBLOCK_MATHEMATICAL_ALPHANUMERIC_SYMBOLS = 93 , /** @draft ICU 2.0 */ UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B = 94 , /** @draft ICU 2.0 */ UBLOCK_CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT = 95 , /** @draft ICU 2.0 */ UBLOCK_TAGS = 96, /* New blocks in Unicode 3.2 */ /** @draft ICU 2.2 */ UBLOCKS_CYRILLIC_SUPPLEMENTARY = 97, /** @draft ICU 2.2 */ UBLOCKS_TAGALOG = 98, /** @draft ICU 2.2 */ UBLOCKS_HANUNOO = 99, /** @draft ICU 2.2 */ UBLOCKS_BUHID = 100, /** @draft ICU 2.2 */ UBLOCKS_TAGBANWA = 101, /** @draft ICU 2.2 */ UBLOCKS_MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A = 102, /** @draft ICU 2.2 */ UBLOCKS_SUPPLEMENTAL_ARROWS_A = 103, /** @draft ICU 2.2 */ UBLOCKS_SUPPLEMENTAL_ARROWS_B = 104, /** @draft ICU 2.2 */ UBLOCKS_MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B = 105, /** @draft ICU 2.2 */ UBLOCKS_SUPPLEMENTAL_MATHEMATICAL_OPERATORS = 106, /** @draft ICU 2.2 */ UBLOCKS_KATAKANA_PHONETIC_EXTENSIONS = 107, /** @draft ICU 2.2 */ UBLOCKS_VARIATION_SELECTORS = 108, /** @draft ICU 2.2 */ UBLOCKS_SUPPLEMENTARY_PRIVATE_USE_AREA_A = 109, /** @draft ICU 2.2 */ UBLOCKS_SUPPLEMENTARY_PRIVATE_USE_AREA_B = 110, /** @draft ICU 2.0 */ UBLOCK_COUNT, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_SCRIPT_COUNT=UBLOCK_COUNT, /** @draft ICU 2.0 */ UBLOCK_INVALID_CODE=-1, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_CHAR_SCRIPT_COUNT =UBLOCK_COUNT, /** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/ U_NO_SCRIPT = UBLOCK_COUNT }; /** @draft ICU 2.0 */ typedef enum UBlockCode UBlockCode; /** * Values returned by the u_getCellWidth() function. * @deprecated To be removed after 2003-jun-30; use UCHAR_EAST_ASIAN_WIDTH. */ enum UCellWidth { /** @stable */ U_ZERO_WIDTH = 0, /** @stable */ U_HALF_WIDTH = 1, /** @stable */ U_FULL_WIDTH = 2, /** @stable */ U_NEUTRAL_WIDTH = 3, /** @stable */ U_CELL_WIDTH_COUNT }; /** @deprecated To be removed after 2003-jun-30; use UCHAR_EAST_ASIAN_WIDTH. */ typedef enum UCellWidth UCellWidth; /** * East Asian Width constants. * * @see UCHAR_EAST_ASIAN_WIDTH * @draft ICU 2.2 */ enum UEastAsianWidth { U_EA_NEUTRAL, U_EA_AMBIGUOUS, U_EA_HALFWIDTH, U_EA_FULLWIDTH, U_EA_NARROW, U_EA_WIDE, U_EA_COUNT }; typedef enum UEastAsianWidth UEastAsianWidth; /* * Implementation note: * Keep UEastAsianWidth constant values in sync with names list in genprops/props2.c. */ /** * Selector constants for u_charName(). * u_charName() returns the "modern" name of a * Unicode character; or the name that was defined in * Unicode version 1.0, before the Unicode standard merged * with ISO-10646; or an "extended" name that gives each * Unicode code point a unique name. * * @see u_charName * @stable */ enum UCharNameChoice { U_UNICODE_CHAR_NAME, U_UNICODE_10_CHAR_NAME, U_EXTENDED_CHAR_NAME, U_CHAR_NAME_CHOICE_COUNT }; /** @stable */ typedef enum UCharNameChoice UCharNameChoice; /** * Decomposition Type constants. * * @see UCHAR_DECOMPOSITION_TYPE * @draft ICU 2.2 */ enum UDecompositionType { U_DT_NONE, U_DT_CANONICAL, U_DT_COMPAT, U_DT_CIRCLE, U_DT_FINAL, U_DT_FONT, U_DT_FRACTION, U_DT_INITIAL, U_DT_ISOLATED, U_DT_MEDIAL, U_DT_NARROW, U_DT_NOBREAK, U_DT_SMALL, U_DT_SQUARE, U_DT_SUB, U_DT_SUPER, U_DT_VERTICAL, U_DT_WIDE, U_DT_COUNT /* 18 */ }; typedef enum UDecompositionType UDecompositionType; /** * Joining Type constants. * * @see UCHAR_JOINING_TYPE * @draft ICU 2.2 */ enum UJoiningType { U_JT_NON_JOINING, U_JT_JOIN_CAUSING, U_JT_DUAL_JOINING, U_JT_LEFT_JOINING, U_JT_RIGHT_JOINING, U_JT_TRANSPARENT, U_JT_COUNT /* 6 */ }; typedef enum UJoiningType UJoiningType; /** * Joining Group constants. * * @see UCHAR_JOINING_GROUP * @draft ICU 2.2 */ enum UJoiningGroup { U_JG_NO_JOINING_GROUP, U_JG_AIN, U_JG_ALAPH, U_JG_ALEF, U_JG_BEH, U_JG_BETH, U_JG_DAL, U_JG_DALATH_RISH, U_JG_E, U_JG_FEH, U_JG_FINAL_SEMKATH, U_JG_GAF, U_JG_GAMAL, U_JG_HAH, U_JG_HAMZA_ON_HEH_GOAL, U_JG_HE, U_JG_HEH, U_JG_HEH_GOAL, U_JG_HETH, U_JG_KAF, U_JG_KAPH, U_JG_KNOTTED_HEH, U_JG_LAM, U_JG_LAMADH, U_JG_MEEM, U_JG_MIM, U_JG_NOON, U_JG_NUN, U_JG_PE, U_JG_QAF, U_JG_QAPH, U_JG_REH, U_JG_REVERSED_PE, U_JG_SAD, U_JG_SADHE, U_JG_SEEN, U_JG_SEMKATH, U_JG_SHIN, U_JG_SWASH_KAF, U_JG_SYRIAC_WAW, U_JG_TAH, U_JG_TAW, U_JG_TEH_MARBUTA, U_JG_TETH, U_JG_WAW, U_JG_YEH, U_JG_YEH_BARREE, U_JG_YEH_WITH_TAIL, U_JG_YUDH, U_JG_YUDH_HE, U_JG_ZAIN, U_JG_COUNT /* 51 */ }; typedef enum UJoiningGroup UJoiningGroup; /** * Line Break constants. * * @see UCHAR_LINE_BREAK * @draft ICU 2.2 */ enum ULineBreak { U_LB_UNKNOWN, U_LB_AMBIGUOUS, U_LB_ALPHABETIC, U_LB_BREAK_BOTH, U_LB_BREAK_AFTER, U_LB_BREAK_BEFORE, U_LB_MANDATORY_BREAK, U_LB_CONTINGENT_BREAK, U_LB_CLOSE_PUNCTUATION, U_LB_COMBINING_MARK, U_LB_CARRIAGE_RETURN, U_LB_EXCLAMATION, U_LB_GLUE, U_LB_HYPHEN, U_LB_IDEOGRAPHIC, U_LB_INSEPERABLE, U_LB_INFIX_NUMERIC, U_LB_LINE_FEED, U_LB_NONSTARTER, U_LB_NUMERIC, U_LB_OPEN_PUNCTUATION, U_LB_POSTFIX_NUMERIC, U_LB_PREFIX_NUMERIC, U_LB_QUOTATION, U_LB_COMPLEX_CONTEXT, U_LB_SURROGATE, U_LB_SPACE, U_LB_BREAK_SYMBOLS, U_LB_ZWSPACE, U_LB_COUNT /* 29 */ }; typedef enum ULineBreak ULineBreak; /** * Numeric Type constants. * * @see UCHAR_NUMERIC_TYPE * @draft ICU 2.2 */ enum UNumericType { U_NT_NONE, U_NT_DECIMAL, U_NT_DIGIT, U_NT_NUMERIC, U_NT_COUNT }; typedef enum UNumericType UNumericType; /** * Check a binary Unicode property for a code point. * * Unicode, especially in version 3.2, defines many more properties than the * original set in UnicodeData.txt. * * The properties APIs are intended to reflect Unicode properties as defined * in the Unicode Character Database (UCD) and Unicode Technical Reports (UTR). * For details about the properties see http://www.unicode.org/ . * For names of Unicode properties see the UCD file PropertyAliases.txt. * * Important: If ICU is built with UCD files from Unicode versions below 3.2, * then properties marked with "new in Unicode 3.2" are not or not fully available. * * @param c Code point to test. * @param which UProperty selector constant, identifies which binary property to check. * Must be UCHAR_BINARY_START<=which *

  • It is a Unicode space separator (category "Zs"), but is not * a no-break space (\u00A0 or \uFEFF). *
  • It is a Unicode line separator (category "Zl"). *
  • It is a Unicode paragraph separator (category "Zp"). *
  • It is \u0009, HORIZONTAL TABULATION. *
  • It is \u000A, LINE FEED. *
  • It is \u000B, VERTICAL TABULATION. *
  • It is \u000C, FORM FEED. *
  • It is \u000D, CARRIAGE RETURN. *
  • It is \u001C, FILE SEPARATOR. *
  • It is \u001D, GROUP SEPARATOR. *
  • It is \u001E, RECORD SEPARATOR. *
  • It is \u001F, UNIT SEPARATOR. * * Note: This method corresponds to the Java method * java.lang.Character.isWhitespace(). * * @param ch the character to be tested. * @return true if the character is an ICU whitespace character; * false otherwise. * @see #u_isspace * @stable */ U_CAPI UBool U_EXPORT2 u_isWhitespace(UChar32 c); /** * Determines whether the specified character is a control character or not. * A control character is one of the following: * - ISO 8-bit control character (U+0000..U+001f and U+007f..U+009f) * - U_CONTROL_CHAR (Cc) * - U_FORMAT_CHAR (Cf) * - U_LINE_SEPARATOR (Zl) * - U_PARAGRAPH_SEPARATOR (Zp) * * @param c the character to be tested * @return true if the Unicode character is a control character; false otherwise. * * @see u_isprint * @stable */ U_CAPI UBool U_EXPORT2 u_iscntrl(UChar32 c); /** * Determines whether the specified character is a printable character according * to UnicodeData.txt. * * @param c the character to be tested * @return true if the Unicode character is a printable character; false otherwise. * * @see u_iscntrl * @stable */ U_CAPI UBool U_EXPORT2 u_isprint(UChar32 c); /** * Determines whether the specified character is of the base form according * to UnicodeData.txt. * * @param c the character to be tested * @return true if the Unicode character is of the base form; false otherwise. * * @see u_isalpha * @see u_isdigit * @stable */ U_CAPI UBool U_EXPORT2 u_isbase(UChar32 c); /** * Returns the linguistic direction property of a character. *

    * Returns the linguistic direction property of a character. * For example, 0x0041 (letter A) has the LEFT_TO_RIGHT directional * property. * @param c The character to be tested * @return the linguistic direction property of a character. * @see UCharDirection * @see UCharDirection * @stable */ U_CAPI UCharDirection U_EXPORT2 u_charDirection(UChar32 c); /** * Determines whether the character has the "mirrored" property. * This property is set for characters that are commonly used in * Right-To-Left contexts and need to be displayed with a "mirrored" * glyph. * * @param c the character (code point, Unicode scalar value) to be tested * @return TRUE if the character has the "mirrored" property * @stable */ U_CAPI UBool U_EXPORT2 u_isMirrored(UChar32 c); /** * Maps the specified character to a "mirror-image" character. * For characters with the "mirrored" property, implementations * sometimes need a "poor man's" mapping to another Unicode * character (code point) such that the default glyph may serve * as the mirror-image of the default glyph of the specified * character. This is useful for text conversion to and from * codepages with visual order, and for displays without glyph * selecetion capabilities. * * @param c the character (code point, Unicode scalar value) to be mapped * @return another Unicode code point that may serve as a mirror-image * substitute, or c itself if there is no such mapping or c * does not have the "mirrored" property * @stable */ U_CAPI UChar32 U_EXPORT2 u_charMirror(UChar32 c); /** * Deprecated because the "cell width" functions and implementation are * out of date compared with Unicode Standard Annex #11. * Use u_getIntPropertyValue with UCHAR_EAST_ASIAN_WIDTH. * See http://www.unicode.org/reports/tr11/ * * Returns a value indicating the display-cell width of the character * when used in Asian text, according to the Unicode standard (see p. 6-130 * of The Unicode Standard, Version 2.0). The results for various characters * are as follows: *

    * U_ZERO_WIDTH: Characters which are considered to take up no display-cell space: * control characters * format characters * line and paragraph separators * non-spacing marks * combining Hangul jungseong * combining Hangul jongseong * unassigned Unicode values *

    * U_HALF_WIDTH: Characters which take up half a cell in standard Asian text: * all characters in the General Scripts Area except combining Hangul choseong * and the characters called out specifically above as ZERO_WIDTH * alphabetic and Arabic presentation forms * halfwidth CJK punctuation * halfwidth Katakana * halfwidth Hangul Jamo * halfwidth forms, arrows, and shapes *

    * U_FULL_WIDTH: Characters which take up a full cell in standard Asian text: * combining Hangul choseong * all characters in the CJK Phonetics and Symbols Area * all characters in the CJK Ideographs Area * all characters in the Hangul Syllables Area * CJK compatibility ideographs * CJK compatibility forms * small form variants * fullwidth ASCII * fullwidth punctuation and currency signs *

    * U_NEUTRAL_WIDTH: Characters whose cell width is context-dependent: * all characters in the Symbols Area, except those specifically called out above * all characters in the Surrogates Area * all charcaters in the Private Use Area *

    * For Korean text, this algorithm should work properly with properly normalized Korean * text. Precomposed Hangul syllables and non-combining jamo are all considered full- * width characters. For combining jamo, we treat we treat choseong (initial consonants) * as double-width characters and junseong (vowels) and jongseong (final consonants) * as non-spacing marks. This will work right in text that uses the precomposed * choseong characters instead of teo choseong characters in a row, and which uses the * choseong filler character at the beginning of syllables that don't have an initial * consonant. The results may be slightly off with Korean text following different * conventions. * @param c The character to be tested * @return a value indicating the display-cell width of the character when used in Asian text * @deprecated To be removed after 2003-jun-30; use UCHAR_EAST_ASIAN_WIDTH. */ U_CAPI uint16_t U_EXPORT2 u_charCellWidth(UChar32 c); /** * Returns a value indicating a character category. * The categories are taken from the Unicode Character Database (UCD) in * UnicodeData.txt. * * @param c the character to be tested * @return a value of type int, the character category. * @see UCharCategory * @stable */ U_CAPI int8_t U_EXPORT2 u_charType(UChar32 c); /** * Get a single-bit bit set for the general category of a character. * This bit set can be compared bitwise with U_GC_SM_MASK, U_GC_L_MASK, etc. * Same as U_MASK(u_charType(c)). * * @see u_charType * @see UCharCategory * @see U_GC_CN_MASK * @draft ICU 2.1 */ #define U_GET_GC_MASK(c) U_MASK(u_charType(c)) /** * Callback from u_enumCharTypes(), is called for each contiguous range * of code points c (where start<=cnameChoice, the character name written * into the buffer is the "modern" name or the name that was defined * in Unicode version 1.0. * The name contains only "invariant" characters * like A-Z, 0-9, space, and '-'. * Unicode 1.0 names are only retrieved if they are different from the modern * names and if the data file contains the data for them. gennames may or may * not be called with a command line option to include 1.0 names in unames.dat. * * @param code The character (code point) for which to get the name. * It must be 0<=code<=0x10ffff. * @param nameChoice Selector for which name to get. * @param buffer Destination address for copying the name. * The name will always be zero-terminated. * If there is no name, then the buffer will be set to the empty string. * @param bufferLength ==sizeof(buffer) * @param pErrorCode Pointer to a UErrorCode variable; * check for U_SUCCESS() after u_charName() * returns. * @return The length of the name, or 0 if there is no name for this character. * If the bufferLength is less than or equal to the length, then the buffer * contains the truncated name and the returned length indicates the full * length of the name. * The length does not include the zero-termination. * * @see UCharNameChoice * @see u_charFromName * @see u_enumCharNames * @stable */ U_CAPI int32_t U_EXPORT2 u_charName(UChar32 code, UCharNameChoice nameChoice, char *buffer, int32_t bufferLength, UErrorCode *pErrorCode); /** * Get the ISO 10646 comment for a character. * The ISO 10646 comment is an informative field in the Unicode Character * Database (UnicodeData.txt field 11) and is from the ISO 10646 names list. * * @param c The character (code point) for which to get the ISO comment. * It must be 0<=c<=0x10ffff. * @param dest Destination address for copying the comment. * The comment will be zero-terminated if possible. * If there is no comment, then the buffer will be set to the empty string. * @param destCapacity ==sizeof(dest) * @param pErrorCode Pointer to a UErrorCode variable; * check for U_SUCCESS() after u_getISOComment() * returns. * @return The length of the comment, or 0 if there is no comment for this character. * If the destCapacity is less than or equal to the length, then the buffer * contains the truncated name and the returned length indicates the full * length of the name. * The length does not include the zero-termination. * * @draft ICU 2.2 */ U_CAPI int32_t U_EXPORT2 u_getISOComment(UChar32 c, char *dest, int32_t destCapacity, UErrorCode *pErrorCode); /** * Find a Unicode character by its name and return its code point value. * The name is matched exactly and completely. * If the name does not correspond to a code point, pErrorCode * is set to U_INVALID_CHAR_FOUND. * A Unicode 1.0 name is matched only if it differs from the modern name. * Unicode names are all uppercase. Extended names are lowercase followed * by an uppercase hexadecimal number, and within angle brackets. * * @param nameChoice Selector for which name to match. * @param name The name to match. * @param pErrorCode Pointer to a UErrorCode variable * @return The Unicode value of the code point with the given name, * or an undefined value if there is no such code point. * * @see UCharNameChoice * @see u_charName * @see u_enumCharNames */ U_CAPI UChar32 U_EXPORT2 u_charFromName(UCharNameChoice nameChoice, const char *name, UErrorCode *pErrorCode); /** * Type of a callback function for u_enumCharNames() that gets called * for each Unicode character with the code point value and * the character name. * If such a function returns FALSE, then the enumeration is stopped. * * @param context The context pointer that was passed to u_enumCharNames(). * @param code The Unicode code point for the character with this name. * @param nameChoice Selector for which kind of names is enumerated. * @param name The character's name, zero-terminated. * @param length The length of the name. * @return TRUE if the enumeration should continue, FALSE to stop it. * * @see UCharNameChoice * @see u_enumCharNames */ typedef UBool UEnumCharNamesFn(void *context, UChar32 code, UCharNameChoice nameChoice, const char *name, int32_t length); /** * Enumerate all assigned Unicode characters between the start and limit * code points (start inclusive, limit exclusive) and call a function * for each, passing the code point value and the character name. * For Unicode 1.0 names, only those are enumerated that differ from the * modern names. * * @param start The first code point in the enumeration range. * @param limit One more than the last code point in the enumeration range * (the first one after the range). * @param fn The function that is to be called for each character name. * @param context An arbitrary pointer that is passed to the function. * @param nameChoice Selector for which kind of names to enumerate. * @param pErrorCode Pointer to a UErrorCode variable * * @see UCharNameChoice * @see UEnumCharNamesFn * @see u_charName * @see u_charFromName */ U_CAPI void U_EXPORT2 u_enumCharNames(UChar32 start, UChar32 limit, UEnumCharNamesFn *fn, void *context, UCharNameChoice nameChoice, UErrorCode *pErrorCode); /** * The following functions are java specific. */ /** * A convenience method for determining if a Unicode character * is allowed to start in a Unicode identifier. * A character may start a Unicode identifier if and only if * it is a letter. * * @param c the Unicode character. * @return TRUE if the character may start a Unicode identifier; * FALSE otherwise. * @see u_isalpha * @see u_isIDPart * @stable */ U_CAPI UBool U_EXPORT2 u_isIDStart(UChar32 c); /** * A convenience method for determining if a Unicode character * may be part of a Unicode identifier other than the starting * character. *

    * A character may be part of a Unicode identifier if and only if * it is one of the following: *

    * * @param c the Unicode character. * @return TRUE if the character may be part of a Unicode identifier; * FALSE otherwise. * @see u_isIDIgnorable * @see u_isIDStart * @stable */ U_CAPI UBool U_EXPORT2 u_isIDPart(UChar32 c); /** * A convenience method for determining if a Unicode character * should be regarded as an ignorable character * in a Unicode identifier. *

    * The following Unicode characters are ignorable in a * Unicode identifier: * * * * * * * * * *
    0x0000 through 0x0008,ISO control characters that
    0x000E through 0x001B, are not whitespace
    and 0x007F through 0x009F
    0x200C through 0x200F join controls
    0x200A through 0x200E bidirectional controls
    0x206A through 0x206F format controls
    0xFEFF zero-width no-break space
    * * @param c the Unicode character. * @return TRUE if the character may be part of a Unicode identifier; * FALSE otherwise. * @see u_isIDPart * @stable */ U_CAPI UBool U_EXPORT2 u_isIDIgnorable(UChar32 c); /** * A convenience method for determining if a Unicode character * is allowed as the first character in a Java identifier. *

    * A character may start a Java identifier if and only if * it is one of the following: *

    * * @param c the Unicode character. * @return TRUE if the character may start a Java identifier; * FALSE otherwise. * @see u_isJavaIDPart * @see u_isalpha * @see u_isIDStart * @stable */ U_CAPI UBool U_EXPORT2 u_isJavaIDStart(UChar32 c); /** * A convenience method for determining if a Unicode character * may be part of a Java identifier other than the starting * character. *

    * A character may be part of a Java identifier if and only if * it is one of the following: *

    * * @param c the Unicode character. * @return TRUE if the character may be part of a Unicode identifier; * FALSE otherwise. * @see u_isIDIgnorable * @see u_isJavaIDStart * @see u_isalpha * @see u_isdigit * @see u_isIDPart * @stable */ U_CAPI UBool U_EXPORT2 u_isJavaIDPart(UChar32 c); /** * Functions to change character case. */ /** * The given character is mapped to its lowercase equivalent according to * UnicodeData.txt; if the character has no lowercase equivalent, the character * itself is returned. *

    * A character has a lowercase equivalent if and only if a lowercase mapping * is specified for the character in the UnicodeData.txt attribute table. *

    * u_tolower() only deals with the general letter case conversion. * For language specific case conversion behavior, use ustrToUpper(). * For example, the case conversion for dot-less i and dotted I in Turkish, * or for final sigma in Greek. * * @param c the character to be converted * @return the lowercase equivalent of the character, if any; * otherwise the character itself. * @stable */ U_CAPI UChar32 U_EXPORT2 u_tolower(UChar32 c); /** * The given character is mapped to its uppercase equivalent according to UnicodeData.txt; * if the character has no uppercase equivalent, the character itself is * returned. *

    * u_toupper() only deals with the general letter case conversion. * For language specific case conversion behavior, use ustrToUpper(). * For example, the case conversion for dot-less i and dotted I in Turkish, * or ess-zed (i.e., "sharp S") in German. * * @param c the character to be converted * @return the uppercase equivalent of the character, if any; * otherwise the character itself. * @stable */ U_CAPI UChar32 U_EXPORT2 u_toupper(UChar32 c); /** * The given character is mapped to its titlecase equivalent according to UnicodeData.txt. * There are only four Unicode characters that are truly titlecase forms * that are distinct from uppercase forms. As a rule, if a character has no * true titlecase equivalent, its uppercase equivalent is returned. *

    * A character has a titlecase equivalent if and only if a titlecase mapping * is specified for the character in the UnicodeData.txt data. * * @param c the character to be converted * @return the titlecase equivalent of the character, if any; * otherwise the character itself. * @stable */ U_CAPI UChar32 U_EXPORT2 u_totitle(UChar32 c); /** Option value for case folding: use default mappings defined in CaseFolding.txt. @stable */ #define U_FOLD_CASE_DEFAULT 0 /** * Option value for case folding: * * Use the modified set of mappings provided in CaseFolding.txt to handle dotted I * and dotless i appropriately for Turkic languages (tr, az). * * Before Unicode 3.2, CaseFolding.txt contains mappings marked with 'I' that * are to be included for default mappings and * excluded for the Turkic-specific mappings. * * Unicode 3.2 CaseFolding.txt instead contains mappings marked with 'T' that * are to be excluded for default mappings and * included for the Turkic-specific mappings. * * @stable */ #define U_FOLD_CASE_EXCLUDE_SPECIAL_I 1 /** * The given character is mapped to its case folding equivalent according to * UnicodeData.txt and CaseFolding.txt; if the character has no case folding equivalent, the character * itself is returned. * Only "simple", single-code point case folding mappings are used. * "Full" mappings are used by u_strFoldCase(). * * @param c the character to be converted * @param options Either U_FOLD_CASE_DEFAULT or U_FOLD_CASE_EXCLUDE_SPECIAL_I * @return the case folding equivalent of the character, if any; * otherwise the character itself. * @draft ICU 1.8 */ U_CAPI UChar32 U_EXPORT2 u_foldCase(UChar32 c, uint32_t options); /** * Returns the numeric value of the character ch in the * specified radix. *

    * If the radix is not in the range 2 <= radix <= 36 or if the * value of ch is not a valid digit in the specified * radix, -1 is returned. A character is a valid digit * if at least one of the following is true: *

    * * @param ch the character to be converted. * @param radix the radix. * @return the numeric value represented by the character in the * specified radix. * * @see u_forDigit * @see u_charDigitValue * @see u_isdigit * @draft ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_digit(UChar32 ch, int8_t radix); /** * Determines the character representation for a specific digit in * the specified radix. If the value of radix is not a * valid radix, or the value of digit is not a valid * digit in the specified radix, the null character * (U+0000) is returned. *

    * The radix argument is valid if it is greater than or * equal to 2 and less than or equal to 36. * The digit argument is valid if * 0 <= digit < radix. *

    * If the digit is less than 10, then * '0' + digit is returned. Otherwise, the value * 'a' + digit - 10 is returned. * * @param digit the number to convert to a character. * @param radix the radix. * @return the char representation of the specified digit * in the specified radix. * * @see u_digit * @see u_charDigitValue * @see u_isdigit * @draft ICU 2.0 */ U_CAPI UChar32 U_EXPORT2 u_forDigit(int32_t digit, int8_t radix); /** * Get the "age" of the code point. * The "age" is the Unicode version when the code point was first * designated (as a non-character or for Private Use) * or assigned a character. * This can be useful to avoid emitting code points to receiving * processes that do not accept newer characters. * The data is from the UCD file DerivedAge.txt. * * @param c The code point. * @param versionArray The Unicode version number array, to be filled in. * * @draft ICU 2.1 */ U_CAPI void U_EXPORT2 u_charAge(UChar32 c, UVersionInfo versionArray); /** * Gets the Unicode version information. The version array stores the version information * for the Unicode standard that is currently used by ICU. For example, release "1.3.31.2" * is then represented as 0x01031F02. * @param versionArray the version # information, the result will be filled in * @stable */ U_CAPI void U_EXPORT2 u_getUnicodeVersion(UVersionInfo info); /** * Get the FC_NFKC_Closure property string for a character. * See Unicode Standard Annex #15 for details, search for "FC_NFKC_Closure" * or for "FNC": http://www.unicode.org/reports/tr15/ * * @param c The character (code point) for which to get the FC_NFKC_Closure string. * It must be 0<=c<=0x10ffff. * @param dest Destination address for copying the string. * The string will be zero-terminated if possible. * If there is no FC_NFKC_Closure string, * then the buffer will be set to the empty string. * @param destCapacity ==sizeof(dest) * @param pErrorCode Pointer to a UErrorCode variable. * @return The length of the string, or 0 if there is no FC_NFKC_Closure string for this character. * If the destCapacity is less than or equal to the length, then the buffer * contains the truncated name and the returned length indicates the full * length of the name. * The length does not include the zero-termination. * * @draft ICU 2.2 */ U_CAPI int32_t U_EXPORT2 u_getFC_NFKC_Closure(UChar32 c, UChar *dest, int32_t destCapacity, UErrorCode *pErrorCode); /** *@deprecated Use u_charBlock instead. Remove after Aug,2002 */ #define u_charScript ublock_getCode /** @deprecated Use the enum UCharBlock instead. Remove after Aug,2002*/ typedef UBlockCode UCharScript; U_CDECL_END #endif /*_UCHAR*/ /*eof*/