#include "unicode/utypes.h"
Go to the source code of this file.
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.
Definition in file uchar.h.
|
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.
|
|
The lowest Unicode code point value. Code points are non-negative.
|
|
Option value for case folding: use default mappings defined in CaseFolding.txt.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
|
|
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.
|
|
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.
|
|
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.
|
|
|
|
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.
|
|
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.
|
|
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.
|
|
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
Value: |
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
|
|
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.
|
|
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.
|
|
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.
|
|
|
|
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)).
|
|
Get a single-bit bit set (a flag) from a bit number 0..31.
|
|
Special value that is returned by u_getNumericValue when no numeric value is defined for a code point.
|
|
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.
|
|
Definition at line 2310 of file uchar.h. Referenced by Unicode::getScript().
|
|
|
|
|
|
|
|
|
|
Callback from u_enumCharTypes(), is called for each contiguous range of code points c (where start<=c<limit) with the same Unicode general category ("character type"). The callback function can stop the enumeration by returning FALSE.
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
Constants for Unicode blocks, generated from Unicode Data file Blocks.txt These are the same values as Unicode::EUnicodeScript.
|
|
Values returned by the u_getCellWidth() function.
|
|
Data for enumerated Unicode general category types. See http://www.unicode.org/Public/UNIDATA/UnicodeData.html .
|
|
|
Selector constants for u_charName().
|
|
Decomposition Type constants.
|
|
East Asian Width constants.
|
|
Joining Group constants.
|
|
Joining Type constants.
|
|
Line Break constants.
|
|
Numeric Type constants.
|
|
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.
|
|
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.
|
|
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.
Referenced by Unicode::getCellWidth().
|
|
Returns the decimal numeric value of a digit character.
Referenced by Unicode::digitValue().
|
|
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.
Referenced by Unicode::characterDirection().
|
|
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
|
|
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.
Referenced by Unicode::charMirror().
|
|
Retrieve the name of a Unicode character.
Depending on
Referenced by Unicode::getCharName().
|
|
Returns a value indicating a character category. The categories are taken from the Unicode Character Database (UCD) in UnicodeData.txt.
Referenced by Unicode::getType().
|
|
Returns the numeric value of the character
If the radix is not in the range
Referenced by Unicode::digit().
|
|
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.
|
|
Enumerate efficiently all code points with their Unicode general categories. This is useful for building data structures (e.g., UnicodeSet's), for enumerating all assigned code points (type!=U_UNASSIGNED), etc. For each contiguous range of code points with a given general category ("character type"), the UCharEnumTypeRange function is called. Adjacent ranges have different types. The Unicode Standard guarantees that the numeric value of the type is 0..31.
|
|
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().
Referenced by Unicode::foldCase().
|
|
Determines the character representation for a specific digit in the specified radix.
If the value of
The
If the digit is less than 10, then
Referenced by Unicode::forDigit().
|
|
Returns the combining class of the code point as specified in UnicodeData.txt.
Referenced by Unicode::getCombiningClass().
|
|
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/
|
|
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.
|
|
Get the maximum value for an enumerated/integer/binary Unicode property. Can be used together with u_getIntPropertyMinValue to allocate arrays of UnicodeSet or similar. Examples for min/max values (for Unicode 3.2):
|
|
Get the minimum value for an enumerated/integer/binary Unicode property. Can be used together with u_getIntPropertyMaxValue to allocate arrays of UnicodeSet or similar.
|
|
Get the property value for an enumerated or integer Unicode property for a code point. Also returns binary property values. 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. Sample usage: UEastAsianWidth ea=(UEastAsianWidth)u_getIntPropertyValue(c, UCHAR_EAST_ASIAN_WIDTH); UBool b=(UBool)u_getIntPropertyValue(c, UCHAR_IDEOGRAPHIC);
|
|
Get the numeric value for a Unicode code point as defined in the Unicode Character Database. A "double" return type is necessary because some numeric values are fractions, negative, or too large for int32_t. For characters without any numeric values in the Unicode Character Database, this function will return U_NO_NUMERIC_VALUE.
|
|
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.
Referenced by Unicode::getUnicodeVersion().
|
|
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.
|
|
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:
Referenced by Unicode::isIdentifierIgnorable().
|
|
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:
Referenced by Unicode::isUnicodeIdentifierPart().
|
|
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.
Referenced by Unicode::isUnicodeIdentifierStart().
|
|
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:
Referenced by Unicode::isJavaIdentifierPart().
|
|
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:
Referenced by Unicode::isJavaIdentifierStart().
|
|
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.
Referenced by Unicode::isMirrored().
|
|
Check if a code point has the Alphabetic Unicode property. Same as u_hasBinaryProperty(c, UCHAR_ALPHABETIC). This is different from u_isalpha!
|
|
Check if a code point has the Lowercase Unicode property. Same as u_hasBinaryProperty(c, UCHAR_LOWERCASE). This is different from u_islower!
|
|
Check if a code point has the Uppercase Unicode property. Same as u_hasBinaryProperty(c, UCHAR_UPPERCASE). This is different from u_isupper!
|
|
Check if a code point has the White_Space Unicode property. Same as u_hasBinaryProperty(c, UCHAR_WHITE_SPACE). This is different from both u_isspace and u_isWhitespace!
|
|
Determines if the specified character is white space according to ICU. A character is considered to be an ICU whitespace character if and only if it satisfies one of the following criteria:
java.lang.Character.isWhitespace() .
Referenced by Unicode::isWhitespace().
|
|
Determines whether the specified character is an alphanumeric character (letter or digit)according to UnicodeData.txt.
|
|
Determines whether the specified character is a letter according to UnicodeData.txt.
Referenced by Unicode::isLetter().
|
|
Determines whether the specified character is of the base form according to UnicodeData.txt.
Referenced by Unicode::isBaseForm().
|
|
Determines whether the specified character is a control character or not. A control character is one of the following:
Referenced by Unicode::isControl().
|
|
Determines whether the specified numeric value is actually a defined character according to UnicodeData.txt.
Referenced by Unicode::isDefined().
|
|
Determines whether the specified character is a digit according to UnicodeData.txt.
Referenced by Unicode::isDigit().
|
|
Determines whether the specified UChar is a lowercase character according to UnicodeData.txt.
Referenced by Unicode::isLowerCase().
|
|
Determines whether the specified character is a printable character according to UnicodeData.txt.
Referenced by Unicode::isPrintable().
|
|
Determines if the specified character is a space character or not.
Referenced by Unicode::isSpaceChar().
|
|
Determines whether the specified character is a titlecase character according to UnicodeData.txt.
Referenced by Unicode::isTitleCase().
|
|
Determines whether the specified character is an uppercase character according to UnicodeData.txt.
Referenced by Unicode::isUpperCase().
|
|
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.
Referenced by Unicode::toLowerCase().
|
|
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.
Referenced by Unicode::toTitleCase().
|
|
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.
Referenced by Unicode::toUpperCase().
|
|
Returns the Unicode allocation block that contains the character.
|