* 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. *
*/ struct UCharDigitPair{ uint16_t fUnicode; int8_t fValue; }; typedef struct UCharDigitPair UCharDigitPair; struct BlockScriptMap { UChar fFirstCode; UChar fLastCode; }; typedef struct BlockScriptMap BlockScriptMap; static bool_t tablesCreated=FALSE; static bool_t ulTablesCreated=FALSE; static bool_t dirTablesCreated=FALSE; static void createTables(void); static void createUlTables(void); static void createDirTables(void); /** * 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 minimum value a UChar can have. The lowest value a * UChar can have is 0x0000. */ static UChar UCHAR_MIN_VALUE; /** * The maximum value a UChar can have. The greatest value a * UChar can have is 0xffff. */ static UChar UCHAR_MAX_VALUE; /** * Data for enumerated Unicode general category types */ enum UCharCategory { UNASSIGNED = 0, UPPERCASE_LETTER = 1, LOWERCASE_LETTER = 2, TITLECASE_LETTER = 3, MODIFIER_LETTER = 4, OTHER_LETTER = 5, NON_SPACING_MARK = 6, ENCLOSING_MARK = 7, COMBINING_SPACING_MARK = 8, DECIMAL_DIGIT_NUMBER = 9, LETTER_NUMBER = 10, OTHER_NUMBER = 11, SPACE_SEPARATOR = 12, LINE_SEPARATOR = 13, PARAGRAPH_SEPARATOR = 14, CONTROL = 15, FORMAT = 16, PRIVATE_USE = 17, SURROGATE = 18, DASH_PUNCTUATION = 19, START_PUNCTUATION = 20, END_PUNCTUATION = 21, CONNECTOR_PUNCTUATION = 22, OTHER_PUNCTUATION = 23, MATH_SYMBOL = 24, CURRENCY_SYMBOL = 25, MODIFIER_SYMBOL = 26, OTHER_SYMBOL = 27, INITIAL_PUNCTUATION = 28, FINAL_PUNCTUATION = 29, GENERAL_OTHER_TYPES = 30 }; typedef enum UCharCategory UCharCategory; /** * This specifies the language directional property of a character set. */ enum UCharDirection { U_LEFT_TO_RIGHT = 0, U_RIGHT_TO_LEFT = 1, U_EUROPEAN_NUMBER = 2, U_EUROPEAN_NUMBER_SEPARATOR = 3, U_EUROPEAN_NUMBER_TERMINATOR = 4, U_ARABIC_NUMBER = 5, U_COMMON_NUMBER_SEPARATOR = 6, U_BLOCK_SEPARATOR = 7, U_SEGMENT_SEPARATOR = 8, U_WHITE_SPACE_NEUTRAL = 9, U_OTHER_NEUTRAL = 10, U_LEFT_TO_RIGHT_EMBEDDING = 11, U_LEFT_TO_RIGHT_OVERRIDE = 12, U_RIGHT_TO_LEFT_ARABIC = 13, U_RIGHT_TO_LEFT_EMBEDDING = 14, U_RIGHT_TO_LEFT_OVERRIDE = 15, U_POP_DIRECTIONAL_FORMAT = 16, U_DIR_NON_SPACING_MARK = 17, U_BOUNDARY_NEUTRAL = 18, UCharDirectionCount }; typedef enum UCharDirection UCharDirection; /** * Script range as defined in the Unicode standard. */ /* Generated from Unicode Data files */ enum UCharScript { /* Script names */ BASIC_LATIN, LATIN_1_SUPPLEMENT, LATIN_EXTENDED_A, LATIN_EXTENDED_B, IPA_EXTENSIONS, SPACING_MODIFIER_LETTERS, COMBINING_DIACRITICAL_MARKS, GREEK, CYRILLIC, ARMENIAN, HEBREW, ARABIC, SYRIAC, THAANA, DEVANAGARI, BENGALI, GURMUKHI, GUJARATI, ORIYA, TAMIL, TELUGU, KANNADA, MALAYALAM, SINHALA, THAI, LAO, TIBETAN, MYANMAR, GEORGIAN, HANGUL_JAMO, ETHIOPIC, CHEROKEE, UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS, OGHAM, RUNIC, KHMER, MONGOLIAN, LATIN_EXTENDED_ADDITIONAL, GREEK_EXTENDED, GENERAL_PUNCTUATION, SUPERSCRIPTS_AND_SUBSCRIPTS, CURRENCY_SYMBOLS, COMBINING_MARKS_FOR_SYMBOLS, LETTERLIKE_SYMBOLS, NUMBER_FORMS, ARROWS, MATHEMATICAL_OPERATORS, MISCELLANEOUS_TECHNICAL, CONTROL_PICTURES, OPTICAL_CHARACTER_RECOGNITION, ENCLOSED_ALPHANUMERICS, BOX_DRAWING, BLOCK_ELEMENTS, GEOMETRIC_SHAPES, MISCELLANEOUS_SYMBOLS, DINGBATS, BRAILLE_PATTERNS, CJK_RADICALS_SUPPLEMENT, KANGXI_RADICALS, IDEOGRAPHIC_DESCRIPTION_CHARACTERS, CJK_SYMBOLS_AND_PUNCTUATION, HIRAGANA, KATAKANA, BOPOMOFO, HANGUL_COMPATIBILITY_JAMO, KANBUN, BOPOMOFO_EXTENDED, ENCLOSED_CJK_LETTERS_AND_MONTHS, CJK_COMPATIBILITY, CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A, CJK_UNIFIED_IDEOGRAPHS, YI_SYLLABLES, YI_RADICALS, HANGUL_SYLLABLES, HIGH_SURROGATES, HIGH_PRIVATE_USE_SURROGATES, LOW_SURROGATES, PRIVATE_USE_AREA, /* PRIVATE_USE */ CJK_COMPATIBILITY_IDEOGRAPHS, ALPHABETIC_PRESENTATION_FORMS, ARABIC_PRESENTATION_FORMS_A, COMBINING_HALF_MARKS, CJK_COMPATIBILITY_FORMS, SMALL_FORM_VARIANTS, ARABIC_PRESENTATION_FORMS_B, SPECIALS, HALFWIDTH_AND_FULLWIDTH_FORMS, SCRIPT_COUNT, NO_SCRIPT, /* Enums for compatibility with ICU 1.2.4 and previous */ LATIN1_SUPPLEMENT=LATIN_1_SUPPLEMENT, IPA_EXTENSION=IPA_EXTENSIONS, SPACING_MODIFIER=SPACING_MODIFIER_LETTERS, COMBINING_DIACRITICAL=COMBINING_DIACRITICAL_MARKS, SUPER_SUBSCRIPT=SUPERSCRIPTS_AND_SUBSCRIPTS, CURRENCY_SYMBOL_SCRIPT=CURRENCY_SYMBOLS, SYMBOL_COMBINING_MARK=COMBINING_MARKS_FOR_SYMBOLS, LETTERLIKE_SYMBOL=LETTERLIKE_SYMBOLS, NUMBER_FORM=NUMBER_FORMS, ARROW=ARROWS, MATH_OPERATOR=MATHEMATICAL_OPERATORS, MISC_TECHNICAL=MISCELLANEOUS_TECHNICAL, CONTROL_PICTURE=CONTROL_PICTURES, OPTICAL_CHARACTER=OPTICAL_CHARACTER_RECOGNITION, ENCLOSED_ALPHANUMERIC=ENCLOSED_ALPHANUMERICS, BOXDRAWING=BOX_DRAWING, BLOCK_ELEMENT=BLOCK_ELEMENTS, GEOMETRIC_SHAPE=GEOMETRIC_SHAPES, MISC_SYMBOL=MISCELLANEOUS_SYMBOLS, DINGBAT=DINGBATS, CJK_SYMBOL_PUNCTUATION=CJK_SYMBOLS_AND_PUNCTUATION, ENCLOSED_CJK_LETTER_MONTH=ENCLOSED_CJK_LETTERS_AND_MONTHS, CJK_UNIFIED_IDEOGRAPH=CJK_UNIFIED_IDEOGRAPHS, HANGUL_SYLLABLE=HANGUL_SYLLABLES, HIGH_SURROGATE=HIGH_SURROGATES, HIGH_PRIVATE_USE_SURROGATE=HIGH_PRIVATE_USE_SURROGATES, LOW_SURROGATE=LOW_SURROGATES, PRIVATE_USE_CHARACTERS=PRIVATE_USE_AREA, CJK_COMPATIBILITY_IDEOGRAPH=CJK_COMPATIBILITY_IDEOGRAPHS, ALPHABETIC_PRESENTATION=ALPHABETIC_PRESENTATION_FORMS, ARABIC_PRESENTATION_A=ARABIC_PRESENTATION_FORMS_A, COMBINING_HALFMARK=COMBINING_HALF_MARKS, CJK_COMPATIBILITY_FORM=CJK_COMPATIBILITY_FORMS, SMALL_FORM_VARIANT=SMALL_FORM_VARIANTS, ARABIC_PRESENTATION_B=ARABIC_PRESENTATION_FORMS_B, HALFWIDTH_FULLWIDTH_FORM=HALFWIDTH_AND_FULLWIDTH_FORMS }; typedef enum UCharScript UCharScript; /** * Values returned by the u_getCellWidth() function. */ enum UCellWidth { ZERO_WIDTH = 0, HALF_WIDTH = 1, FULL_WIDTH = 2, NEUTRAL = 3 }; typedef enum UCellWidth UCellWidth; /** * Functions to classify characters. */ /** * Determines whether the specified UChar is a lowercase character * according to Unicode 2.1.2. * * @param ch the character to be tested * @return true if the character is lowercase; false otherwise. * @see UNICODE_VERSION * @see uisupper() * @see uistitle() * @see uislower() */ CAPI bool_t U_EXPORT2 u_islower(UChar c); /** * Determines whether the specified character is an uppercase character * according to Unicode 2.1.2. * * @param ch the character to be tested * @return true if the character is uppercase; false otherwise. * @see uislower() * @see uistitle * @see utolower() */ CAPI bool_t U_EXPORT2 u_isupper(UChar c); /** * Determines whether the specified character is a titlecase character * according to Unicode 2.1.2. * * @param ch the character to be tested * @return true if the character is titlecase; false otherwise. * @see uisupper() * @see uislower() * @see utotitle() */ CAPI bool_t U_EXPORT2 u_istitle(UChar c); /** * Determines whether the specified character is a digit according to Unicode * 2.1.2. * * @param ch the character to be tested * @return true if the character is a digit; false otherwise. */ CAPI bool_t U_EXPORT2 u_isdigit(UChar c); /** * Determines whether the specified numeric value is actually a defined character * according to Unicode 2.1.2. * * @param ch the character to be tested * @return true if the character has a defined Unicode meaning; false otherwise. * * @see uisdigit() * @see uisalpha() * @see uisalnum() * @see uisupper() * @see uislower() * @see uistitle() */ CAPI bool_t U_EXPORT2 u_isdefined(UChar c); /** * Determines whether the specified character is a letter * according to Unicode 2.1.2. * * @param ch the character to be tested * @return true if the character is a letter; false otherwise. * * @see uisdigit() * @see uisalnum() */ CAPI bool_t U_EXPORT2 u_isalpha(UChar c); /** * Determines if the specified character is a space character or not. * * @param ch the character to be tested * @return true if the character is a space character; false otherwise. */ CAPI bool_t U_EXPORT2 u_isspace(UChar c); /** * Determines whether the specified character is a control character or not. * * @param ch the character to be tested * @return true if the Unicode character is a control character; false otherwise. * * @see uisprint() */ CAPI bool_t U_EXPORT2 u_iscntrl(UChar c); /** * Determines whether the specified character is a printable character according * to Unicode 2.1.2. * * @param ch the character to be tested * @return true if the Unicode character is a printable character; false otherwise. * * @see uiscntrl() */ CAPI bool_t U_EXPORT2 u_isprint(UChar c); /** * Determines whether the specified character is of the base form according * to Unicode 2.1.2. * * @param ch the character to be tested * @return true if the Unicode character is of the base form; false otherwise. * * @see uisalpha() * @see uisdigit() */ CAPI bool_t U_EXPORT2 u_isbase(UChar 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. * @see UCharDirection */ CAPI UCharDirection U_EXPORT2 u_charDirection(UChar c); /** * 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: *
* 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 *
* 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 *
* 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 *
* NEUTRAL: 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. */ CAPI uint16_t U_EXPORT2 u_charCellWidth(UChar c); /** * Returns a value indicating a character category according to Unicode * 2.1.2. * @param c the character to be tested * @return a value of type int, the character category. * @see UCharCategory */ CAPI int8_t U_EXPORT2 u_charType(UChar c); /** * Retrives the decimal numeric value of a digit character. * @param c the digit character for which to get the numeric value * @return the numeric value of ch in decimal radix. This method returns * -1 if ch is not a valid digit character. */ CAPI int32_t U_EXPORT2 u_charDigitValue(UChar c); /** * * Returns the script associated with a character. * @see #UCharScript */ CAPI UCharScript U_EXPORT2 u_charScript(UChar ch); /** * 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 */ CAPI bool_t U_EXPORT2 u_isIDStart(UChar 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: *
* 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 |
* A character may start a Java identifier if and only if * it is one of the following: *
* A character may be part of a Java identifier if and only if * it is one of the following: *
* A character has a lowercase equivalent if and only if a lowercase mapping * is specified for the character in the Unicode 2.1.2 attribute table. *
* utolower() 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 ch the character to be converted * @return the lowercase equivalent of the character, if any; * otherwise the character itself. */ CAPI UChar U_EXPORT2 u_tolower(UChar c); /** * The given character is mapped to its uppercase equivalent according to Unicode * 2.1.2; if the character has no uppercase equivalent, the character itself is * returned. *
* utoupper() 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 ch the character to be converted * @return the uppercase equivalent of the character, if any; * otherwise the character itself. */ CAPI UChar U_EXPORT2 u_toupper(UChar c); /** * The given character is mapped to its titlecase equivalent according to Unicode * 2.1.2. 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 Unicode 2.1.2 data. * * @param ch the character to be converted * @return the titlecase equivalent of the character, if any; * otherwise the character itself. */ CAPI UChar U_EXPORT2 u_totitle(UChar c); /** * *The function is used to get the Unicode standard Version that is used *@return the Unicode stabdard Version number */ CAPI const char* U_EXPORT2 u_getVersion(void); #endif /*_UCHAR*/ /*eof*/