Defines | |||
![]() | ![]() | #define | U_UNICODE_VERSION |
Typedefs | |||
![]() | ![]() | typedef enum UCharCategory | UCharCategory |
![]() | ![]() | typedef enum UCharDirection | UCharDirection |
![]() | ![]() | typedef enum UCharScript | UCharScript |
![]() | ![]() | typedef enum UCellWidth | UCellWidth |
![]() | ![]() | typedef enum UCharNameChoice | UCharNameChoice |
Enumerations | |||
![]() | ![]() | enum | UCharCategory { U_UNASSIGNED, U_UPPERCASE_LETTER, U_LOWERCASE_LETTER, U_TITLECASE_LETTER, U_MODIFIER_LETTER, U_OTHER_LETTER, U_NON_SPACING_MARK, U_ENCLOSING_MARK, U_COMBINING_SPACING_MARK, U_DECIMAL_DIGIT_NUMBER, U_LETTER_NUMBER, U_OTHER_NUMBER, U_SPACE_SEPARATOR, U_LINE_SEPARATOR, U_PARAGRAPH_SEPARATOR, U_CONTROL_CHAR, U_FORMAT_CHAR, U_PRIVATE_USE_CHAR, U_SURROGATE, U_DASH_PUNCTUATION, U_START_PUNCTUATION, U_END_PUNCTUATION, U_CONNECTOR_PUNCTUATION, U_OTHER_PUNCTUATION, U_MATH_SYMBOL, U_CURRENCY_SYMBOL, U_MODIFIER_SYMBOL, U_OTHER_SYMBOL, U_INITIAL_PUNCTUATION, U_FINAL_PUNCTUATION, U_GENERAL_OTHER_TYPES, U_CHAR_CATEGORY_COUNT } |
![]() | ![]() | Data for enumerated Unicode general category types. More... | |
![]() | ![]() | enum | UCharDirection { U_LEFT_TO_RIGHT, U_RIGHT_TO_LEFT, U_EUROPEAN_NUMBER, U_EUROPEAN_NUMBER_SEPARATOR, U_EUROPEAN_NUMBER_TERMINATOR, U_ARABIC_NUMBER, U_COMMON_NUMBER_SEPARATOR, U_BLOCK_SEPARATOR, U_SEGMENT_SEPARATOR, U_WHITE_SPACE_NEUTRAL, U_OTHER_NEUTRAL, U_LEFT_TO_RIGHT_EMBEDDING, U_LEFT_TO_RIGHT_OVERRIDE, U_RIGHT_TO_LEFT_ARABIC, U_RIGHT_TO_LEFT_EMBEDDING, U_RIGHT_TO_LEFT_OVERRIDE, U_POP_DIRECTIONAL_FORMAT, U_DIR_NON_SPACING_MARK, U_BOUNDARY_NEUTRAL, U_CHAR_DIRECTION_COUNT } |
![]() | ![]() | This specifies the language directional property of a character set. More... | |
![]() | ![]() | enum | UCharScript { U_BASIC_LATIN, U_LATIN_1_SUPPLEMENT, U_LATIN_EXTENDED_A, U_LATIN_EXTENDED_B, U_IPA_EXTENSIONS, U_SPACING_MODIFIER_LETTERS, U_COMBINING_DIACRITICAL_MARKS, U_GREEK, U_CYRILLIC, U_ARMENIAN, U_HEBREW, U_ARABIC, U_SYRIAC, U_THAANA, U_DEVANAGARI, U_BENGALI, U_GURMUKHI, U_GUJARATI, U_ORIYA, U_TAMIL, U_TELUGU, U_KANNADA, U_MALAYALAM, U_SINHALA, U_THAI, U_LAO, U_TIBETAN, U_MYANMAR, U_GEORGIAN, U_HANGUL_JAMO, U_ETHIOPIC, U_CHEROKEE, U_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS, U_OGHAM, U_RUNIC, U_KHMER, U_MONGOLIAN, U_LATIN_EXTENDED_ADDITIONAL, U_GREEK_EXTENDED, U_GENERAL_PUNCTUATION, U_SUPERSCRIPTS_AND_SUBSCRIPTS, U_CURRENCY_SYMBOLS, U_COMBINING_MARKS_FOR_SYMBOLS, U_LETTERLIKE_SYMBOLS, U_NUMBER_FORMS, U_ARROWS, U_MATHEMATICAL_OPERATORS, U_MISCELLANEOUS_TECHNICAL, U_CONTROL_PICTURES, U_OPTICAL_CHARACTER_RECOGNITION, U_ENCLOSED_ALPHANUMERICS, U_BOX_DRAWING, U_BLOCK_ELEMENTS, U_GEOMETRIC_SHAPES, U_MISCELLANEOUS_SYMBOLS, U_DINGBATS, U_BRAILLE_PATTERNS, U_CJK_RADICALS_SUPPLEMENT, U_KANGXI_RADICALS, U_IDEOGRAPHIC_DESCRIPTION_CHARACTERS, U_CJK_SYMBOLS_AND_PUNCTUATION, U_HIRAGANA, U_KATAKANA, U_BOPOMOFO, U_HANGUL_COMPATIBILITY_JAMO, U_KANBUN, U_BOPOMOFO_EXTENDED, U_ENCLOSED_CJK_LETTERS_AND_MONTHS, U_CJK_COMPATIBILITY, U_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A, U_CJK_UNIFIED_IDEOGRAPHS, U_YI_SYLLABLES, U_YI_RADICALS, U_HANGUL_SYLLABLES, U_HIGH_SURROGATES, U_HIGH_PRIVATE_USE_SURROGATES, U_LOW_SURROGATES, U_PRIVATE_USE_AREA, U_CJK_COMPATIBILITY_IDEOGRAPHS, U_ALPHABETIC_PRESENTATION_FORMS, U_ARABIC_PRESENTATION_FORMS_A, U_COMBINING_HALF_MARKS, U_CJK_COMPATIBILITY_FORMS, U_SMALL_FORM_VARIANTS, U_ARABIC_PRESENTATION_FORMS_B, U_SPECIALS, U_HALFWIDTH_AND_FULLWIDTH_FORMS, U_CHAR_SCRIPT_COUNT, U_NO_SCRIPT } |
![]() | ![]() | Generated from Unicode Data files. More... | |
![]() | ![]() | enum | UCellWidth { U_ZERO_WIDTH, U_HALF_WIDTH, U_FULL_WIDTH, U_NEUTRAL_WIDTH, U_CELL_WIDTH_COUNT } |
![]() | ![]() | Values returned by the u_getCellWidth() function. More... | |
![]() | ![]() | enum | UCharNameChoice { U_UNICODE_CHAR_NAME, U_UNICODE_10_CHAR_NAME, U_CHAR_NAME_CHOICE_COUNT } |
![]() | ![]() | Selector constants for u_charName(). More... | |
Functions | |||
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_islower (UChar c) |
![]() | ![]() | Determines whether the specified UChar is a lowercase character according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isupper (UChar c) |
![]() | ![]() | Determines whether the specified character is an uppercase character according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_istitle (UChar c) |
![]() | ![]() | Determines whether the specified character is a titlecase character according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isdigit (UChar c) |
![]() | ![]() | Determines whether the specified character is a digit according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isalnum (UChar c) |
![]() | ![]() | Determines whether the specified character is an alphanumeric character (letter or digit)according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isdefined (UChar c) |
![]() | ![]() | Determines whether the specified numeric value is actually a defined character according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isalpha (UChar c) |
![]() | ![]() | Determines whether the specified character is a letter according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isspace (UChar c) |
![]() | ![]() | Determines if the specified character is a space character or not. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_iscntrl (UChar c) |
![]() | ![]() | Determines whether the specified character is a control character or not. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isprint (UChar c) |
![]() | ![]() | Determines whether the specified character is a printable character according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isbase (UChar c) |
![]() | ![]() | Determines whether the specified character is of the base form according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI UCharDirection U_EXPORT2 | u_charDirection (UChar c) |
![]() | ![]() | Returns the linguistic direction property of a character. More... | |
![]() | ![]() | U_CAPI uint16_t U_EXPORT2 | u_charCellWidth (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. More... | |
![]() | ![]() | U_CAPI int8_t U_EXPORT2 | u_charType (UChar c) |
![]() | ![]() | Returns a value indicating a character category according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_charDigitValue (UChar c) |
![]() | ![]() | Retrives the decimal numeric value of a digit character. More... | |
![]() | ![]() | U_CAPI UCharScript U_EXPORT2 | u_charScript (UChar ch) |
![]() | ![]() | Returns the script associated with a character. More... | |
![]() | ![]() | U_CAPI UTextOffset U_EXPORT2 | u_charName (uint32_t code, UCharNameChoice nameChoice, char *buffer, UTextOffset bufferLength, UErrorCode *pErrorCode) |
![]() | ![]() | Retrieve the name of a Unicode character. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isIDStart (UChar c) |
![]() | ![]() | A convenience method for determining if a Unicode character is allowed to start in a Unicode identifier. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isIDPart (UChar c) |
![]() | ![]() | A convenience method for determining if a Unicode character may be part of a Unicode identifier other than the starting character. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isIDIgnorable (UChar c) |
![]() | ![]() | A convenience method for determining if a Unicode character should be regarded as an ignorable character in a Unicode identifier. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isJavaIDStart (UChar c) |
![]() | ![]() | A convenience method for determining if a Unicode character is allowed as the first character in a Java identifier. More... | |
![]() | ![]() | U_CAPI bool_t U_EXPORT2 | u_isJavaIDPart (UChar c) |
![]() | ![]() | A convenience method for determining if a Unicode character may be part of a Java identifier other than the starting character. More... | |
![]() | ![]() | U_CAPI UChar U_EXPORT2 | u_tolower (UChar c) |
![]() | ![]() | The given character is mapped to its lowercase equivalent according to Unicode 2.1.2; if the character has no lowercase equivalent, the character itself is returned. More... | |
![]() | ![]() | U_CAPI UChar U_EXPORT2 | u_toupper (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. More... | |
![]() | ![]() | U_CAPI UChar U_EXPORT2 | u_totitle (UChar c) |
![]() | ![]() | The given character is mapped to its titlecase equivalent according to Unicode 2.1.2. More... | |
![]() | ![]() | U_CAPI void U_EXPORT2 | u_getUnicodeVersion (UVersionInfo info) |
![]() | ![]() | Gets the Unicode version information. More... | |
Variables | |||
![]() | ![]() | UChar | UCHAR_MIN_VALUE |
![]() | ![]() | The minimum value a UChar can have. More... | |
![]() | ![]() | UChar | UCHAR_MAX_VALUE |
![]() | ![]() | The maximum value a UChar can have. More... |
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.
#define U_UNICODE_VERSION () |
typedef enum UCharCategory UCharCategory |
typedef enum UCharDirection UCharDirection |
typedef enum UCharScript UCharScript |
typedef enum UCellWidth UCellWidth |
typedef enum UCharNameChoice UCharNameChoice |
enum UCharCategory |
Data for enumerated Unicode general category types.
enum UCharDirection |
This specifies the language directional property of a character set.
enum UCharScript |
Generated from Unicode Data files.
enum UCellWidth |
Values returned by the u_getCellWidth() function.
U_ZERO_WIDTH | |
U_HALF_WIDTH | |
U_FULL_WIDTH | |
U_NEUTRAL_WIDTH | |
U_CELL_WIDTH_COUNT |
enum UCharNameChoice |
Selector constants for u_charName().
u_charName() returns either 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.
U_UNICODE_CHAR_NAME
U_UNICODE_10_CHAR_NAME
U_CHAR_NAME_CHOICE_COUNT
U_CAPI bool_t U_EXPORT2 u_islower (UChar c) |
Determines whether the specified UChar is a lowercase character according to Unicode 2.1.2.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_isupper (UChar c) |
Determines whether the specified character is an uppercase character according to Unicode 2.1.2.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_istitle (UChar c) |
Determines whether the specified character is a titlecase character according to Unicode 2.1.2.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_isdigit (UChar c) |
Determines whether the specified character is a digit according to Unicode 2.1.2.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_isalnum (UChar c) |
Determines whether the specified character is an alphanumeric character (letter or digit)according to Unicode 2.1.2.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_isdefined (UChar c) |
Determines whether the specified numeric value is actually a defined character according to Unicode 2.1.2.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_isalpha (UChar c) |
Determines whether the specified character is a letter according to Unicode 2.1.2.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_isspace (UChar c) |
Determines if the specified character is a space character or not.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_iscntrl (UChar c) |
Determines whether the specified character is a control character or not.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_isprint (UChar c) |
Determines whether the specified character is a printable character according to Unicode 2.1.2.
ch | the character to be tested |
U_CAPI bool_t U_EXPORT2 u_isbase (UChar c) |
Determines whether the specified character is of the base form according to Unicode 2.1.2.
ch | the character to be tested |
U_CAPI UCharDirection U_EXPORT2 u_charDirection (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.
U_CAPI uint16_t U_EXPORT2 u_charCellWidth (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.
U_CAPI int8_t U_EXPORT2 u_charType (UChar c) |
Returns a value indicating a character category according to Unicode 2.1.2.
c | the character to be tested |
U_CAPI int32_t U_EXPORT2 u_charDigitValue (UChar c) |
Retrives the decimal numeric value of a digit character.
c | the digit character for which to get the numeric value |
U_CAPI UCharScript U_EXPORT2 u_charScript (UChar ch) |
U_CAPI UTextOffset U_EXPORT2 u_charName (uint32_t code, UCharNameChoice nameChoice, char * buffer, UTextOffset bufferLength, UErrorCode * pErrorCode) |
Retrieve the name of a Unicode character.
Depending on nameChoice
, 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 '-'.
code |
The character (code point) for which to get the name. It must be 0<=code<0x10ffff . |
nameChoice | Selector for which name to get. |
buffer | Destination address for copying the name. |
bufferLength |
==sizeof(buffer) |
pErrorCode |
Pointer to a UErrorCode variable; check for U_SUCCESS() after u_charName() returns.
|
U_CAPI bool_t U_EXPORT2 u_isIDStart (UChar c) |
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.
c | the Unicode character. |
U_CAPI bool_t U_EXPORT2 u_isIDPart (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:
c | the Unicode character. |
U_CAPI bool_t U_EXPORT2 u_isIDIgnorable (UChar 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 |
c | the Unicode character. |
U_CAPI bool_t U_EXPORT2 u_isJavaIDStart (UChar 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:
c | the Unicode character. |
U_CAPI bool_t U_EXPORT2 u_isJavaIDPart (UChar 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:
c | the Unicode character. |
U_CAPI UChar U_EXPORT2 u_tolower (UChar c) |
The given character is mapped to its lowercase equivalent according to Unicode 2.1.2; 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 Unicode 2.1.2 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.
ch | the character to be converted |
U_CAPI UChar U_EXPORT2 u_toupper (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.
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.
ch | the character to be converted |
U_CAPI UChar U_EXPORT2 u_totitle (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.
ch | the character to be converted |
U_CAPI void U_EXPORT2 u_getUnicodeVersion (UVersionInfo info) |
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.
versionArray | the version # information, the result will be filled in |
UChar UCHAR_MIN_VALUE [static]
|
The minimum value a UChar can have.
The lowest value a UChar can have is 0x0000.
UChar UCHAR_MAX_VALUE [static]
|
The maximum value a UChar can have.
The greatest value a UChar can have is 0xffff.