ICU 76.1 76.1
|
C API: Unicode Properties. More...
#include <stdbool.h>
#include "unicode/utypes.h"
#include "unicode/stringoptions.h"
#include "unicode/ucpmap.h"
Go to the source code of this file.
Macros | |
#define | U_UNICODE_VERSION "16.0" |
Unicode version number, default for the current ICU version. | |
#define | UCHAR_MIN_VALUE 0 |
Constants. | |
#define | UCHAR_MAX_VALUE 0x10ffff |
The highest Unicode code point value (scalar value) according to The Unicode Standard. | |
#define | U_MASK(x) ((uint32_t)1<<(x)) |
Get a single-bit bit set (a flag) from a bit number 0..31. | |
#define | U_GC_CN_MASK U_MASK(U_GENERAL_OTHER_TYPES) |
U_GC_XX_MASK constants are bit flags corresponding to Unicode general category values. | |
#define | U_GC_LU_MASK U_MASK(U_UPPERCASE_LETTER) |
Mask constant for a UCharCategory. | |
#define | U_GC_LL_MASK U_MASK(U_LOWERCASE_LETTER) |
Mask constant for a UCharCategory. | |
#define | U_GC_LT_MASK U_MASK(U_TITLECASE_LETTER) |
Mask constant for a UCharCategory. | |
#define | U_GC_LM_MASK U_MASK(U_MODIFIER_LETTER) |
Mask constant for a UCharCategory. | |
#define | U_GC_LO_MASK U_MASK(U_OTHER_LETTER) |
Mask constant for a UCharCategory. | |
#define | U_GC_MN_MASK U_MASK(U_NON_SPACING_MARK) |
Mask constant for a UCharCategory. | |
#define | U_GC_ME_MASK U_MASK(U_ENCLOSING_MARK) |
Mask constant for a UCharCategory. | |
#define | U_GC_MC_MASK U_MASK(U_COMBINING_SPACING_MARK) |
Mask constant for a UCharCategory. | |
#define | U_GC_ND_MASK U_MASK(U_DECIMAL_DIGIT_NUMBER) |
Mask constant for a UCharCategory. | |
#define | U_GC_NL_MASK U_MASK(U_LETTER_NUMBER) |
Mask constant for a UCharCategory. | |
#define | U_GC_NO_MASK U_MASK(U_OTHER_NUMBER) |
Mask constant for a UCharCategory. | |
#define | U_GC_ZS_MASK U_MASK(U_SPACE_SEPARATOR) |
Mask constant for a UCharCategory. | |
#define | U_GC_ZL_MASK U_MASK(U_LINE_SEPARATOR) |
Mask constant for a UCharCategory. | |
#define | U_GC_ZP_MASK U_MASK(U_PARAGRAPH_SEPARATOR) |
Mask constant for a UCharCategory. | |
#define | U_GC_CC_MASK U_MASK(U_CONTROL_CHAR) |
Mask constant for a UCharCategory. | |
#define | U_GC_CF_MASK U_MASK(U_FORMAT_CHAR) |
Mask constant for a UCharCategory. | |
#define | U_GC_CO_MASK U_MASK(U_PRIVATE_USE_CHAR) |
Mask constant for a UCharCategory. | |
#define | U_GC_CS_MASK U_MASK(U_SURROGATE) |
Mask constant for a UCharCategory. | |
#define | U_GC_PD_MASK U_MASK(U_DASH_PUNCTUATION) |
Mask constant for a UCharCategory. | |
#define | U_GC_PS_MASK U_MASK(U_START_PUNCTUATION) |
Mask constant for a UCharCategory. | |
#define | U_GC_PE_MASK U_MASK(U_END_PUNCTUATION) |
Mask constant for a UCharCategory. | |
#define | U_GC_PC_MASK U_MASK(U_CONNECTOR_PUNCTUATION) |
Mask constant for a UCharCategory. | |
#define | U_GC_PO_MASK U_MASK(U_OTHER_PUNCTUATION) |
Mask constant for a UCharCategory. | |
#define | U_GC_SM_MASK U_MASK(U_MATH_SYMBOL) |
Mask constant for a UCharCategory. | |
#define | U_GC_SC_MASK U_MASK(U_CURRENCY_SYMBOL) |
Mask constant for a UCharCategory. | |
#define | U_GC_SK_MASK U_MASK(U_MODIFIER_SYMBOL) |
Mask constant for a UCharCategory. | |
#define | U_GC_SO_MASK U_MASK(U_OTHER_SYMBOL) |
Mask constant for a UCharCategory. | |
#define | U_GC_PI_MASK U_MASK(U_INITIAL_PUNCTUATION) |
Mask constant for a UCharCategory. | |
#define | U_GC_PF_MASK U_MASK(U_FINAL_PUNCTUATION) |
Mask constant for a UCharCategory. | |
#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) |
Mask constant for multiple UCharCategory bits (L Letters). | |
#define | U_GC_LC_MASK (U_GC_LU_MASK|U_GC_LL_MASK|U_GC_LT_MASK) |
Mask constant for multiple UCharCategory bits (LC Cased Letters). | |
#define | U_GC_M_MASK (U_GC_MN_MASK|U_GC_ME_MASK|U_GC_MC_MASK) |
Mask constant for multiple UCharCategory bits (M Marks). | |
#define | U_GC_N_MASK (U_GC_ND_MASK|U_GC_NL_MASK|U_GC_NO_MASK) |
Mask constant for multiple UCharCategory bits (N Numbers). | |
#define | U_GC_Z_MASK (U_GC_ZS_MASK|U_GC_ZL_MASK|U_GC_ZP_MASK) |
Mask constant for multiple UCharCategory bits (Z Separators). | |
#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) |
Mask constant for multiple UCharCategory bits (C Others). | |
#define | U_GC_P_MASK |
Mask constant for multiple UCharCategory bits (P Punctuation). | |
#define | U_GC_S_MASK (U_GC_SM_MASK|U_GC_SC_MASK|U_GC_SK_MASK|U_GC_SO_MASK) |
Mask constant for multiple UCharCategory bits (S Symbols). | |
#define | U_NO_NUMERIC_VALUE ((double)-123456789.) |
Special value that is returned by u_getNumericValue when no numeric value is defined for a code point. | |
#define | U_GET_GC_MASK(c) U_MASK(u_charType(c)) |
Get a single-bit bit set for the general category of a character. | |
Typedefs | |
typedef enum UProperty | UProperty |
Selection constants for Unicode properties. | |
typedef enum UCharCategory | UCharCategory |
Data for enumerated Unicode general category types. | |
typedef enum UCharDirection | UCharDirection |
This specifies the language directional property of a character set. | |
typedef enum UBidiPairedBracketType | UBidiPairedBracketType |
Bidi Paired Bracket Type constants. | |
typedef enum UBlockCode | UBlockCode |
typedef enum UEastAsianWidth | UEastAsianWidth |
East Asian Width constants. | |
typedef enum UCharNameChoice | UCharNameChoice |
Selector constants for u_charName(). | |
typedef enum UPropertyNameChoice | UPropertyNameChoice |
Selector constants for u_getPropertyName() and u_getPropertyValueName(). | |
typedef enum UDecompositionType | UDecompositionType |
Decomposition Type constants. | |
typedef enum UJoiningType | UJoiningType |
Joining Type constants. | |
typedef enum UJoiningGroup | UJoiningGroup |
Joining Group constants. | |
typedef enum UGraphemeClusterBreak | UGraphemeClusterBreak |
Grapheme Cluster Break constants. | |
typedef enum UWordBreakValues | UWordBreakValues |
Word Break constants. | |
typedef enum USentenceBreak | USentenceBreak |
Sentence Break constants. | |
typedef enum ULineBreak | ULineBreak |
Line Break constants. | |
typedef enum UNumericType | UNumericType |
Numeric Type constants. | |
typedef enum UHangulSyllableType | UHangulSyllableType |
Hangul Syllable Type constants. | |
typedef enum UIndicPositionalCategory | UIndicPositionalCategory |
Indic Positional Category constants. | |
typedef enum UIndicSyllabicCategory | UIndicSyllabicCategory |
Indic Syllabic Category constants. | |
typedef enum UIndicConjunctBreak | UIndicConjunctBreak |
Indic Conjunct Break constants. | |
typedef enum UVerticalOrientation | UVerticalOrientation |
Vertical Orientation constants. | |
typedef enum UIdentifierStatus | UIdentifierStatus |
Identifier Status constants. | |
typedef enum UIdentifierType | UIdentifierType |
Identifier Type constants. | |
typedef UBool | UCharEnumTypeRange(const void *context, UChar32 start, UChar32 limit, UCharCategory type) |
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"). | |
typedef UBool | UEnumCharNamesFn(void *context, UChar32 code, UCharNameChoice nameChoice, const char *name, int32_t length) |
Type of a callback function for u_enumCharNames() that gets called for each Unicode character with the code point value and the character name. | |
Functions | |
U_CAPI UBool | u_hasBinaryProperty (UChar32 c, UProperty which) |
Check a binary Unicode property for a code point. | |
U_CAPI UBool | u_stringHasBinaryProperty (const UChar *s, int32_t length, UProperty which) |
Returns true if the property is true for the string. | |
U_CAPI const USet * | u_getBinaryPropertySet (UProperty property, UErrorCode *pErrorCode) |
Returns a frozen USet for a binary property. | |
U_CAPI UBool | u_isUAlphabetic (UChar32 c) |
Check if a code point has the Alphabetic Unicode property. | |
U_CAPI UBool | u_isULowercase (UChar32 c) |
Check if a code point has the Lowercase Unicode property. | |
U_CAPI UBool | u_isUUppercase (UChar32 c) |
Check if a code point has the Uppercase Unicode property. | |
U_CAPI UBool | u_isUWhiteSpace (UChar32 c) |
Check if a code point has the White_Space Unicode property. | |
U_CAPI int32_t | u_getIntPropertyValue (UChar32 c, UProperty which) |
Get the property value for an enumerated or integer Unicode property for a code point. | |
U_CAPI int32_t | u_getIntPropertyMinValue (UProperty which) |
Get the minimum value for an enumerated/integer/binary Unicode property. | |
U_CAPI int32_t | u_getIntPropertyMaxValue (UProperty which) |
Get the maximum value for an enumerated/integer/binary Unicode property. | |
U_CAPI const UCPMap * | u_getIntPropertyMap (UProperty property, UErrorCode *pErrorCode) |
Returns an immutable UCPMap for an enumerated/catalog/int-valued property. | |
U_CAPI double | u_getNumericValue (UChar32 c) |
Get the numeric value for a Unicode code point as defined in the Unicode Character Database. | |
U_CAPI UBool | u_islower (UChar32 c) |
Determines whether the specified code point has the general category "Ll" (lowercase letter). | |
U_CAPI UBool | u_isupper (UChar32 c) |
Determines whether the specified code point has the general category "Lu" (uppercase letter). | |
U_CAPI UBool | u_istitle (UChar32 c) |
Determines whether the specified code point is a titlecase letter. | |
U_CAPI UBool | u_isdigit (UChar32 c) |
Determines whether the specified code point is a digit character according to Java. | |
U_CAPI UBool | u_isalpha (UChar32 c) |
Determines whether the specified code point is a letter character. | |
U_CAPI UBool | u_isalnum (UChar32 c) |
Determines whether the specified code point is an alphanumeric character (letter or digit) according to Java. | |
U_CAPI UBool | u_isxdigit (UChar32 c) |
Determines whether the specified code point is a hexadecimal digit. | |
U_CAPI UBool | u_ispunct (UChar32 c) |
Determines whether the specified code point is a punctuation character. | |
U_CAPI UBool | u_isgraph (UChar32 c) |
Determines whether the specified code point is a "graphic" character (printable, excluding spaces). | |
U_CAPI UBool | u_isblank (UChar32 c) |
Determines whether the specified code point is a "blank" or "horizontal space", a character that visibly separates words on a line. | |
U_CAPI UBool | u_isdefined (UChar32 c) |
Determines whether the specified code point is "defined", which usually means that it is assigned a character. | |
U_CAPI UBool | u_isspace (UChar32 c) |
Determines if the specified character is a space character or not. | |
U_CAPI UBool | u_isJavaSpaceChar (UChar32 c) |
Determine if the specified code point is a space character according to Java. | |
U_CAPI UBool | u_isWhitespace (UChar32 c) |
Determines if the specified code point is a whitespace character according to Java/ICU. | |
U_CAPI UBool | u_iscntrl (UChar32 c) |
Determines whether the specified code point is a control character (as defined by this function). | |
U_CAPI UBool | u_isISOControl (UChar32 c) |
Determines whether the specified code point is an ISO control code. | |
U_CAPI UBool | u_isprint (UChar32 c) |
Determines whether the specified code point is a printable character. | |
U_CAPI UBool | u_isbase (UChar32 c) |
Non-standard: Determines whether the specified code point is a base character. | |
U_CAPI UCharDirection | u_charDirection (UChar32 c) |
Returns the bidirectional category value for the code point, which is used in the Unicode bidirectional algorithm (UAX #9 http://www.unicode.org/reports/tr9/). | |
U_CAPI UBool | u_isMirrored (UChar32 c) |
Determines whether the code point has the Bidi_Mirrored property. | |
U_CAPI UChar32 | u_charMirror (UChar32 c) |
Maps the specified character to a "mirror-image" character. | |
U_CAPI UChar32 | u_getBidiPairedBracket (UChar32 c) |
Maps the specified character to its paired bracket character. | |
U_CAPI int8_t | u_charType (UChar32 c) |
Returns the general category value for the code point. | |
U_CAPI void | u_enumCharTypes (UCharEnumTypeRange *enumRange, const void *context) |
Enumerate efficiently all code points with their Unicode general categories. | |
U_CAPI uint8_t | u_getCombiningClass (UChar32 c) |
Returns the combining class of the code point as specified in UnicodeData.txt. | |
U_CAPI int32_t | u_charDigitValue (UChar32 c) |
Returns the decimal digit value of a decimal digit character. | |
U_CAPI UBlockCode | ublock_getCode (UChar32 c) |
Returns the Unicode allocation block that contains the character. | |
U_CAPI int32_t | u_charName (UChar32 code, UCharNameChoice nameChoice, char *buffer, int32_t bufferLength, UErrorCode *pErrorCode) |
Retrieve the name of a Unicode character. | |
int32_t | u_getISOComment (UChar32 c, char *dest, int32_t destCapacity, UErrorCode *pErrorCode) |
Returns an empty string. | |
U_CAPI UChar32 | u_charFromName (UCharNameChoice nameChoice, const char *name, UErrorCode *pErrorCode) |
Find a Unicode character by its name and return its code point value. | |
U_CAPI void | u_enumCharNames (UChar32 start, UChar32 limit, UEnumCharNamesFn *fn, void *context, UCharNameChoice nameChoice, UErrorCode *pErrorCode) |
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. | |
U_CAPI const char * | u_getPropertyName (UProperty property, UPropertyNameChoice nameChoice) |
Return the Unicode name for a given property, as given in the Unicode database file PropertyAliases.txt. | |
U_CAPI UProperty | u_getPropertyEnum (const char *alias) |
Return the UProperty enum for a given property name, as specified in the Unicode database file PropertyAliases.txt. | |
U_CAPI const char * | u_getPropertyValueName (UProperty property, int32_t value, UPropertyNameChoice nameChoice) |
Return the Unicode name for a given property value, as given in the Unicode database file PropertyValueAliases.txt. | |
U_CAPI int32_t | u_getPropertyValueEnum (UProperty property, const char *alias) |
Return the property value integer for a given value name, as specified in the Unicode database file PropertyValueAliases.txt. | |
U_CAPI UBool | u_isIDStart (UChar32 c) |
Determines if the specified character is permissible as the first character in an identifier according to UAX #31 Unicode Identifier and Pattern Syntax. | |
U_CAPI UBool | u_isIDPart (UChar32 c) |
Determines if the specified character is permissible as a non-initial character of an identifier according to UAX #31 Unicode Identifier and Pattern Syntax. | |
U_CAPI bool | u_hasIDType (UChar32 c, UIdentifierType type) |
Does the set of Identifier_Type values code point c contain the given type? | |
U_CAPI int32_t | u_getIDTypes (UChar32 c, UIdentifierType *types, int32_t capacity, UErrorCode *pErrorCode) |
Writes code point c's Identifier_Type as a list of UIdentifierType values to the output types array and returns the number of types. | |
U_CAPI UBool | u_isIDIgnorable (UChar32 c) |
Determines if the specified character should be regarded as an ignorable character in an identifier, according to Java. | |
U_CAPI UBool | u_isJavaIDStart (UChar32 c) |
Determines if the specified character is permissible as the first character in a Java identifier. | |
U_CAPI UBool | u_isJavaIDPart (UChar32 c) |
Determines if the specified character is permissible in a Java identifier. | |
U_CAPI UChar32 | u_tolower (UChar32 c) |
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. | |
U_CAPI UChar32 | u_toupper (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_CAPI UChar32 | u_totitle (UChar32 c) |
The given character is mapped to its titlecase equivalent according to UnicodeData.txt; if none is defined, the character itself is returned. | |
U_CAPI UChar32 | u_foldCase (UChar32 c, uint32_t options) |
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. | |
U_CAPI int32_t | u_digit (UChar32 ch, int8_t radix) |
Returns the decimal digit value of the code point in the specified radix. | |
U_CAPI UChar32 | u_forDigit (int32_t digit, int8_t radix) |
Determines the character representation for a specific digit in the specified radix. | |
U_CAPI void | u_charAge (UChar32 c, UVersionInfo versionArray) |
Get the "age" of the code point. | |
U_CAPI void | u_getUnicodeVersion (UVersionInfo versionArray) |
Gets the Unicode version information. | |
U_CAPI int32_t | u_getFC_NFKC_Closure (UChar32 c, UChar *dest, int32_t destCapacity, UErrorCode *pErrorCode) |
Get the FC_NFKC_Closure property string for a character. | |
C API: Unicode Properties.
This C API provides low-level access to the Unicode Character Database. In addition to raw property values, some convenience functions calculate derived properties, for example for Java-style programming.
Unicode assigns each code point (not just assigned character) values for many properties. Most of them are simple boolean flags, or constants from a small enumerated list. For some properties, values are strings or other relatively more complex types.
For more information see "About the Unicode Character Database" (http://www.unicode.org/ucd/) and the ICU User Guide chapter on Properties (https://unicode-org.github.io/icu/userguide/strings/properties).
Many properties are accessible via generic functions that take a UProperty selector.
Many functions are designed to match java.lang.Character functions. See the individual function documentation, and see the JDK 1.4 java.lang.Character documentation at http://java.sun.com/j2se/1.4/docs/api/java/lang/Character.html
There are also functions that provide easy migration from C/POSIX functions like isblank(). Their use is generally discouraged because the C/POSIX standards do not define their semantics beyond the ASCII range, which means that different implementations exhibit very different behavior. Instead, Unicode properties should be used directly.
There are also only a few, broad C/POSIX character classes, and they tend to be used for conflicting purposes. For example, the "isalpha()" class is sometimes used to determine word boundaries, while a more sophisticated approach would at least distinguish initial letters from continuation characters (the latter including combining marks). (In ICU, BreakIterator is the most sophisticated API for word boundaries.) Another example: There is no "istitle()" class for titlecase characters.
ICU 3.4 and later provides API access for all twelve C/POSIX character classes. ICU implements them according to the Standard Recommendations in Annex C: Compatibility Properties of UTS #18 Unicode Regular Expressions (http://www.unicode.org/reports/tr18/#Compatibility_Properties).
API access for C/POSIX character classes is as follows:
Note: Some of the u_isxyz() functions in uchar.h predate, and do not match, the Standard Recommendations in UTS #18. Instead, they match Java functions according to their API documentation.
The C/POSIX character classes are also available in UnicodeSet patterns, using patterns like [:graph:] or \p{graph}.
Note: There are several ICU whitespace functions. Comparison:
Definition in file uchar.h.
#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_CC_MASK U_MASK(U_CONTROL_CHAR) |
#define U_GC_CF_MASK U_MASK(U_FORMAT_CHAR) |
#define U_GC_CN_MASK U_MASK(U_GENERAL_OTHER_TYPES) |
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.
#define U_GC_CO_MASK U_MASK(U_PRIVATE_USE_CHAR) |
#define U_GC_CS_MASK U_MASK(U_SURROGATE) |
#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_LC_MASK (U_GC_LU_MASK|U_GC_LL_MASK|U_GC_LT_MASK) |
#define U_GC_LL_MASK U_MASK(U_LOWERCASE_LETTER) |
#define U_GC_LM_MASK U_MASK(U_MODIFIER_LETTER) |
#define U_GC_LO_MASK U_MASK(U_OTHER_LETTER) |
#define U_GC_LT_MASK U_MASK(U_TITLECASE_LETTER) |
#define U_GC_LU_MASK U_MASK(U_UPPERCASE_LETTER) |
#define U_GC_M_MASK (U_GC_MN_MASK|U_GC_ME_MASK|U_GC_MC_MASK) |
#define U_GC_MC_MASK U_MASK(U_COMBINING_SPACING_MARK) |
#define U_GC_ME_MASK U_MASK(U_ENCLOSING_MARK) |
#define U_GC_MN_MASK U_MASK(U_NON_SPACING_MARK) |
#define U_GC_N_MASK (U_GC_ND_MASK|U_GC_NL_MASK|U_GC_NO_MASK) |
#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_P_MASK |
#define U_GC_PC_MASK U_MASK(U_CONNECTOR_PUNCTUATION) |
#define U_GC_PD_MASK U_MASK(U_DASH_PUNCTUATION) |
#define U_GC_PE_MASK U_MASK(U_END_PUNCTUATION) |
#define U_GC_PF_MASK U_MASK(U_FINAL_PUNCTUATION) |
#define U_GC_PI_MASK U_MASK(U_INITIAL_PUNCTUATION) |
#define U_GC_PO_MASK U_MASK(U_OTHER_PUNCTUATION) |
#define U_GC_PS_MASK U_MASK(U_START_PUNCTUATION) |
#define U_GC_S_MASK (U_GC_SM_MASK|U_GC_SC_MASK|U_GC_SK_MASK|U_GC_SO_MASK) |
#define U_GC_SC_MASK U_MASK(U_CURRENCY_SYMBOL) |
#define U_GC_SK_MASK U_MASK(U_MODIFIER_SYMBOL) |
#define U_GC_SM_MASK U_MASK(U_MATH_SYMBOL) |
#define U_GC_SO_MASK U_MASK(U_OTHER_SYMBOL) |
#define U_GC_Z_MASK (U_GC_ZS_MASK|U_GC_ZL_MASK|U_GC_ZP_MASK) |
#define U_GC_ZL_MASK U_MASK(U_LINE_SEPARATOR) |
#define U_GC_ZP_MASK U_MASK(U_PARAGRAPH_SEPARATOR) |
#define U_GC_ZS_MASK U_MASK(U_SPACE_SEPARATOR) |
#define U_GET_GC_MASK | ( | c | ) | U_MASK(u_charType(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)).
c | the code point to be tested |
#define U_MASK | ( | x | ) | ((uint32_t)1<<(x)) |
#define U_NO_NUMERIC_VALUE ((double)-123456789.) |
Special value that is returned by u_getNumericValue when no numeric value is defined for a code point.
#define U_UNICODE_VERSION "16.0" |
Unicode version number, default for the current ICU version.
The actual Unicode Character Database (UCD) data is stored in uprops.icu and may be generated from UCD files from a different Unicode version. Call u_getUnicodeVersion to get the actual Unicode version of the data.
#define UCHAR_MAX_VALUE 0x10ffff |
#define UCHAR_MIN_VALUE 0 |
typedef enum UBidiPairedBracketType UBidiPairedBracketType |
typedef enum UBlockCode UBlockCode |
typedef enum UCharCategory UCharCategory |
Data for enumerated Unicode general category types.
See http://www.unicode.org/Public/UNIDATA/UnicodeData.html .
typedef enum UCharDirection UCharDirection |
This specifies the language directional property of a character set.
typedef UBool UCharEnumTypeRange(const void *context, UChar32 start, UChar32 limit, UCharCategory type) |
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.
context | an opaque pointer, as passed into utrie_enum() |
start | the first code point in a contiguous range with value |
limit | one past the last code point in a contiguous range with value |
type | the general category for all code points in [start..limit[ |
typedef enum UCharNameChoice UCharNameChoice |
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.
typedef enum UDecompositionType UDecompositionType |
typedef enum UEastAsianWidth UEastAsianWidth |
typedef UBool UEnumCharNamesFn(void *context, UChar32 code, UCharNameChoice nameChoice, const char *name, int32_t length) |
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.
context | The context pointer that was passed to u_enumCharNames(). |
code | The Unicode code point for the character with this name. |
nameChoice | Selector for which kind of names is enumerated. |
name | The character's name, zero-terminated. |
length | The length of the name. |
typedef enum UGraphemeClusterBreak UGraphemeClusterBreak |
typedef enum UHangulSyllableType UHangulSyllableType |
typedef enum UIdentifierStatus UIdentifierStatus |
Identifier Status constants.
See https://www.unicode.org/reports/tr39/#Identifier_Status_and_Type.
typedef enum UIdentifierType UIdentifierType |
Identifier Type constants.
See https://www.unicode.org/reports/tr39/#Identifier_Status_and_Type.
typedef enum UIndicConjunctBreak UIndicConjunctBreak |
Indic Conjunct Break constants.
typedef enum UIndicPositionalCategory UIndicPositionalCategory |
typedef enum UIndicSyllabicCategory UIndicSyllabicCategory |
typedef enum UJoiningGroup UJoiningGroup |
typedef enum UJoiningType UJoiningType |
typedef enum ULineBreak ULineBreak |
typedef enum UNumericType UNumericType |
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 UAX #44: Unicode Character Database (http://www.unicode.org/reports/tr44/).
Important: If ICU is built with UCD files from Unicode versions below, e.g., 3.2, then properties marked with "new in Unicode 3.2" are not or not fully available. Check u_getUnicodeVersion to be sure.
typedef enum UPropertyNameChoice UPropertyNameChoice |
Selector constants for u_getPropertyName() and u_getPropertyValueName().
These selectors are used to choose which name is returned for a given property or value. All properties and values have a long name. Most have a short name, but some do not. Unicode allows for additional names, beyond the long and short name, which would be indicated by U_LONG_PROPERTY_NAME + i, where i=1, 2,...
typedef enum USentenceBreak USentenceBreak |
typedef enum UVerticalOrientation UVerticalOrientation |
typedef enum UWordBreakValues UWordBreakValues |
Word Break constants.
(UWordBreak is a pre-existing enum type in ubrk.h for word break status tags.)
Bidi Paired Bracket Type constants.
Enumerator | |
---|---|
U_BPT_NONE | Not a paired bracket.
|
U_BPT_OPEN | Open paired bracket.
|
U_BPT_CLOSE | Close paired bracket.
|
U_BPT_COUNT | One more than the highest normal UBidiPairedBracketType value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_BIDI_PAIRED_BRACKET_TYPE).
|
enum UBlockCode |
Constants for Unicode blocks, see the Unicode Data file Blocks.txt.
Enumerator | |
---|---|
UBLOCK_NO_BLOCK | New No_Block value in Unicode 4.
|
UBLOCK_BASIC_LATIN |
|
UBLOCK_LATIN_1_SUPPLEMENT |
|
UBLOCK_LATIN_EXTENDED_A |
|
UBLOCK_LATIN_EXTENDED_B |
|
UBLOCK_IPA_EXTENSIONS |
|
UBLOCK_SPACING_MODIFIER_LETTERS |
|
UBLOCK_COMBINING_DIACRITICAL_MARKS |
|
UBLOCK_GREEK | Unicode 3.2 renames this block to "Greek and Coptic".
|
UBLOCK_CYRILLIC |
|
UBLOCK_ARMENIAN |
|
UBLOCK_HEBREW |
|
UBLOCK_ARABIC |
|
UBLOCK_SYRIAC |
|
UBLOCK_THAANA |
|
UBLOCK_DEVANAGARI |
|
UBLOCK_BENGALI |
|
UBLOCK_GURMUKHI |
|
UBLOCK_GUJARATI |
|
UBLOCK_ORIYA |
|
UBLOCK_TAMIL |
|
UBLOCK_TELUGU |
|
UBLOCK_KANNADA |
|
UBLOCK_MALAYALAM |
|
UBLOCK_SINHALA |
|
UBLOCK_THAI |
|
UBLOCK_LAO |
|
UBLOCK_TIBETAN |
|
UBLOCK_MYANMAR |
|
UBLOCK_GEORGIAN |
|
UBLOCK_HANGUL_JAMO |
|
UBLOCK_ETHIOPIC |
|
UBLOCK_CHEROKEE |
|
UBLOCK_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS |
|
UBLOCK_OGHAM |
|
UBLOCK_RUNIC |
|
UBLOCK_KHMER |
|
UBLOCK_MONGOLIAN |
|
UBLOCK_LATIN_EXTENDED_ADDITIONAL |
|
UBLOCK_GREEK_EXTENDED |
|
UBLOCK_GENERAL_PUNCTUATION |
|
UBLOCK_SUPERSCRIPTS_AND_SUBSCRIPTS |
|
UBLOCK_CURRENCY_SYMBOLS |
|
UBLOCK_COMBINING_MARKS_FOR_SYMBOLS | Unicode 3.2 renames this block to "Combining Diacritical Marks for Symbols".
|
UBLOCK_LETTERLIKE_SYMBOLS |
|
UBLOCK_NUMBER_FORMS |
|
UBLOCK_ARROWS |
|
UBLOCK_MATHEMATICAL_OPERATORS |
|
UBLOCK_MISCELLANEOUS_TECHNICAL |
|
UBLOCK_CONTROL_PICTURES |
|
UBLOCK_OPTICAL_CHARACTER_RECOGNITION |
|
UBLOCK_ENCLOSED_ALPHANUMERICS |
|
UBLOCK_BOX_DRAWING |
|
UBLOCK_BLOCK_ELEMENTS |
|
UBLOCK_GEOMETRIC_SHAPES |
|
UBLOCK_MISCELLANEOUS_SYMBOLS |
|
UBLOCK_DINGBATS |
|
UBLOCK_BRAILLE_PATTERNS |
|
UBLOCK_CJK_RADICALS_SUPPLEMENT |
|
UBLOCK_KANGXI_RADICALS |
|
UBLOCK_IDEOGRAPHIC_DESCRIPTION_CHARACTERS |
|
UBLOCK_CJK_SYMBOLS_AND_PUNCTUATION |
|
UBLOCK_HIRAGANA |
|
UBLOCK_KATAKANA |
|
UBLOCK_BOPOMOFO |
|
UBLOCK_HANGUL_COMPATIBILITY_JAMO |
|
UBLOCK_KANBUN |
|
UBLOCK_BOPOMOFO_EXTENDED |
|
UBLOCK_ENCLOSED_CJK_LETTERS_AND_MONTHS |
|
UBLOCK_CJK_COMPATIBILITY |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS |
|
UBLOCK_YI_SYLLABLES |
|
UBLOCK_YI_RADICALS |
|
UBLOCK_HANGUL_SYLLABLES |
|
UBLOCK_HIGH_SURROGATES |
|
UBLOCK_HIGH_PRIVATE_USE_SURROGATES |
|
UBLOCK_LOW_SURROGATES |
|
UBLOCK_PRIVATE_USE_AREA | Same as UBLOCK_PRIVATE_USE. Until Unicode 3.1.1, the corresponding block name was "Private Use", and multiple code point ranges had this block. Unicode 3.2 renames the block for the BMP PUA to "Private Use Area" and adds separate blocks for the supplementary PUAs.
|
UBLOCK_PRIVATE_USE | Same as UBLOCK_PRIVATE_USE_AREA. Until Unicode 3.1.1, the corresponding block name was "Private Use", and multiple code point ranges had this block. Unicode 3.2 renames the block for the BMP PUA to "Private Use Area" and adds separate blocks for the supplementary PUAs.
|
UBLOCK_CJK_COMPATIBILITY_IDEOGRAPHS |
|
UBLOCK_ALPHABETIC_PRESENTATION_FORMS |
|
UBLOCK_ARABIC_PRESENTATION_FORMS_A |
|
UBLOCK_COMBINING_HALF_MARKS |
|
UBLOCK_CJK_COMPATIBILITY_FORMS |
|
UBLOCK_SMALL_FORM_VARIANTS |
|
UBLOCK_ARABIC_PRESENTATION_FORMS_B |
|
UBLOCK_SPECIALS |
|
UBLOCK_HALFWIDTH_AND_FULLWIDTH_FORMS |
|
UBLOCK_OLD_ITALIC |
|
UBLOCK_GOTHIC |
|
UBLOCK_DESERET |
|
UBLOCK_BYZANTINE_MUSICAL_SYMBOLS |
|
UBLOCK_MUSICAL_SYMBOLS |
|
UBLOCK_MATHEMATICAL_ALPHANUMERIC_SYMBOLS |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B |
|
UBLOCK_CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT |
|
UBLOCK_TAGS |
|
UBLOCK_CYRILLIC_SUPPLEMENT |
|
UBLOCK_CYRILLIC_SUPPLEMENTARY | Unicode 4.0.1 renames the "Cyrillic Supplementary" block to "Cyrillic Supplement".
|
UBLOCK_TAGALOG |
|
UBLOCK_HANUNOO |
|
UBLOCK_BUHID |
|
UBLOCK_TAGBANWA |
|
UBLOCK_MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A |
|
UBLOCK_SUPPLEMENTAL_ARROWS_A |
|
UBLOCK_SUPPLEMENTAL_ARROWS_B |
|
UBLOCK_MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B |
|
UBLOCK_SUPPLEMENTAL_MATHEMATICAL_OPERATORS |
|
UBLOCK_KATAKANA_PHONETIC_EXTENSIONS |
|
UBLOCK_VARIATION_SELECTORS |
|
UBLOCK_SUPPLEMENTARY_PRIVATE_USE_AREA_A |
|
UBLOCK_SUPPLEMENTARY_PRIVATE_USE_AREA_B |
|
UBLOCK_LIMBU |
|
UBLOCK_TAI_LE |
|
UBLOCK_KHMER_SYMBOLS |
|
UBLOCK_PHONETIC_EXTENSIONS |
|
UBLOCK_MISCELLANEOUS_SYMBOLS_AND_ARROWS |
|
UBLOCK_YIJING_HEXAGRAM_SYMBOLS |
|
UBLOCK_LINEAR_B_SYLLABARY |
|
UBLOCK_LINEAR_B_IDEOGRAMS |
|
UBLOCK_AEGEAN_NUMBERS |
|
UBLOCK_UGARITIC |
|
UBLOCK_SHAVIAN |
|
UBLOCK_OSMANYA |
|
UBLOCK_CYPRIOT_SYLLABARY |
|
UBLOCK_TAI_XUAN_JING_SYMBOLS |
|
UBLOCK_VARIATION_SELECTORS_SUPPLEMENT |
|
UBLOCK_ANCIENT_GREEK_MUSICAL_NOTATION |
|
UBLOCK_ANCIENT_GREEK_NUMBERS |
|
UBLOCK_ARABIC_SUPPLEMENT |
|
UBLOCK_BUGINESE |
|
UBLOCK_CJK_STROKES |
|
UBLOCK_COMBINING_DIACRITICAL_MARKS_SUPPLEMENT |
|
UBLOCK_COPTIC |
|
UBLOCK_ETHIOPIC_EXTENDED |
|
UBLOCK_ETHIOPIC_SUPPLEMENT |
|
UBLOCK_GEORGIAN_SUPPLEMENT |
|
UBLOCK_GLAGOLITIC |
|
UBLOCK_KHAROSHTHI |
|
UBLOCK_MODIFIER_TONE_LETTERS |
|
UBLOCK_NEW_TAI_LUE |
|
UBLOCK_OLD_PERSIAN |
|
UBLOCK_PHONETIC_EXTENSIONS_SUPPLEMENT |
|
UBLOCK_SUPPLEMENTAL_PUNCTUATION |
|
UBLOCK_SYLOTI_NAGRI |
|
UBLOCK_TIFINAGH |
|
UBLOCK_VERTICAL_FORMS |
|
UBLOCK_NKO |
|
UBLOCK_BALINESE |
|
UBLOCK_LATIN_EXTENDED_C |
|
UBLOCK_LATIN_EXTENDED_D |
|
UBLOCK_PHAGS_PA |
|
UBLOCK_PHOENICIAN |
|
UBLOCK_CUNEIFORM |
|
UBLOCK_CUNEIFORM_NUMBERS_AND_PUNCTUATION |
|
UBLOCK_COUNTING_ROD_NUMERALS |
|
UBLOCK_SUNDANESE |
|
UBLOCK_LEPCHA |
|
UBLOCK_OL_CHIKI |
|
UBLOCK_CYRILLIC_EXTENDED_A |
|
UBLOCK_VAI |
|
UBLOCK_CYRILLIC_EXTENDED_B |
|
UBLOCK_SAURASHTRA |
|
UBLOCK_KAYAH_LI |
|
UBLOCK_REJANG |
|
UBLOCK_CHAM |
|
UBLOCK_ANCIENT_SYMBOLS |
|
UBLOCK_PHAISTOS_DISC |
|
UBLOCK_LYCIAN |
|
UBLOCK_CARIAN |
|
UBLOCK_LYDIAN |
|
UBLOCK_MAHJONG_TILES |
|
UBLOCK_DOMINO_TILES |
|
UBLOCK_SAMARITAN |
|
UBLOCK_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS_EXTENDED |
|
UBLOCK_TAI_THAM |
|
UBLOCK_VEDIC_EXTENSIONS |
|
UBLOCK_LISU |
|
UBLOCK_BAMUM |
|
UBLOCK_COMMON_INDIC_NUMBER_FORMS |
|
UBLOCK_DEVANAGARI_EXTENDED |
|
UBLOCK_HANGUL_JAMO_EXTENDED_A |
|
UBLOCK_JAVANESE |
|
UBLOCK_MYANMAR_EXTENDED_A |
|
UBLOCK_TAI_VIET |
|
UBLOCK_MEETEI_MAYEK |
|
UBLOCK_HANGUL_JAMO_EXTENDED_B |
|
UBLOCK_IMPERIAL_ARAMAIC |
|
UBLOCK_OLD_SOUTH_ARABIAN |
|
UBLOCK_AVESTAN |
|
UBLOCK_INSCRIPTIONAL_PARTHIAN |
|
UBLOCK_INSCRIPTIONAL_PAHLAVI |
|
UBLOCK_OLD_TURKIC |
|
UBLOCK_RUMI_NUMERAL_SYMBOLS |
|
UBLOCK_KAITHI |
|
UBLOCK_EGYPTIAN_HIEROGLYPHS |
|
UBLOCK_ENCLOSED_ALPHANUMERIC_SUPPLEMENT |
|
UBLOCK_ENCLOSED_IDEOGRAPHIC_SUPPLEMENT |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_C |
|
UBLOCK_MANDAIC |
|
UBLOCK_BATAK |
|
UBLOCK_ETHIOPIC_EXTENDED_A |
|
UBLOCK_BRAHMI |
|
UBLOCK_BAMUM_SUPPLEMENT |
|
UBLOCK_KANA_SUPPLEMENT |
|
UBLOCK_PLAYING_CARDS |
|
UBLOCK_MISCELLANEOUS_SYMBOLS_AND_PICTOGRAPHS |
|
UBLOCK_EMOTICONS |
|
UBLOCK_TRANSPORT_AND_MAP_SYMBOLS |
|
UBLOCK_ALCHEMICAL_SYMBOLS |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_D |
|
UBLOCK_ARABIC_EXTENDED_A |
|
UBLOCK_ARABIC_MATHEMATICAL_ALPHABETIC_SYMBOLS |
|
UBLOCK_CHAKMA |
|
UBLOCK_MEETEI_MAYEK_EXTENSIONS |
|
UBLOCK_MEROITIC_CURSIVE |
|
UBLOCK_MEROITIC_HIEROGLYPHS |
|
UBLOCK_MIAO |
|
UBLOCK_SHARADA |
|
UBLOCK_SORA_SOMPENG |
|
UBLOCK_SUNDANESE_SUPPLEMENT |
|
UBLOCK_TAKRI |
|
UBLOCK_BASSA_VAH |
|
UBLOCK_CAUCASIAN_ALBANIAN |
|
UBLOCK_COPTIC_EPACT_NUMBERS |
|
UBLOCK_COMBINING_DIACRITICAL_MARKS_EXTENDED |
|
UBLOCK_DUPLOYAN |
|
UBLOCK_ELBASAN |
|
UBLOCK_GEOMETRIC_SHAPES_EXTENDED |
|
UBLOCK_GRANTHA |
|
UBLOCK_KHOJKI |
|
UBLOCK_KHUDAWADI |
|
UBLOCK_LATIN_EXTENDED_E |
|
UBLOCK_LINEAR_A |
|
UBLOCK_MAHAJANI |
|
UBLOCK_MANICHAEAN |
|
UBLOCK_MENDE_KIKAKUI |
|
UBLOCK_MODI |
|
UBLOCK_MRO |
|
UBLOCK_MYANMAR_EXTENDED_B |
|
UBLOCK_NABATAEAN |
|
UBLOCK_OLD_NORTH_ARABIAN |
|
UBLOCK_OLD_PERMIC |
|
UBLOCK_ORNAMENTAL_DINGBATS |
|
UBLOCK_PAHAWH_HMONG |
|
UBLOCK_PALMYRENE |
|
UBLOCK_PAU_CIN_HAU |
|
UBLOCK_PSALTER_PAHLAVI |
|
UBLOCK_SHORTHAND_FORMAT_CONTROLS |
|
UBLOCK_SIDDHAM |
|
UBLOCK_SINHALA_ARCHAIC_NUMBERS |
|
UBLOCK_SUPPLEMENTAL_ARROWS_C |
|
UBLOCK_TIRHUTA |
|
UBLOCK_WARANG_CITI |
|
UBLOCK_AHOM |
|
UBLOCK_ANATOLIAN_HIEROGLYPHS |
|
UBLOCK_CHEROKEE_SUPPLEMENT |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_E |
|
UBLOCK_EARLY_DYNASTIC_CUNEIFORM |
|
UBLOCK_HATRAN |
|
UBLOCK_MULTANI |
|
UBLOCK_OLD_HUNGARIAN |
|
UBLOCK_SUPPLEMENTAL_SYMBOLS_AND_PICTOGRAPHS |
|
UBLOCK_SUTTON_SIGNWRITING |
|
UBLOCK_ADLAM |
|
UBLOCK_BHAIKSUKI |
|
UBLOCK_CYRILLIC_EXTENDED_C |
|
UBLOCK_GLAGOLITIC_SUPPLEMENT |
|
UBLOCK_IDEOGRAPHIC_SYMBOLS_AND_PUNCTUATION |
|
UBLOCK_MARCHEN |
|
UBLOCK_MONGOLIAN_SUPPLEMENT |
|
UBLOCK_NEWA |
|
UBLOCK_OSAGE |
|
UBLOCK_TANGUT |
|
UBLOCK_TANGUT_COMPONENTS |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_F |
|
UBLOCK_KANA_EXTENDED_A |
|
UBLOCK_MASARAM_GONDI |
|
UBLOCK_NUSHU |
|
UBLOCK_SOYOMBO |
|
UBLOCK_SYRIAC_SUPPLEMENT |
|
UBLOCK_ZANABAZAR_SQUARE |
|
UBLOCK_CHESS_SYMBOLS |
|
UBLOCK_DOGRA |
|
UBLOCK_GEORGIAN_EXTENDED |
|
UBLOCK_GUNJALA_GONDI |
|
UBLOCK_HANIFI_ROHINGYA |
|
UBLOCK_INDIC_SIYAQ_NUMBERS |
|
UBLOCK_MAKASAR |
|
UBLOCK_MAYAN_NUMERALS |
|
UBLOCK_MEDEFAIDRIN |
|
UBLOCK_OLD_SOGDIAN |
|
UBLOCK_SOGDIAN |
|
UBLOCK_EGYPTIAN_HIEROGLYPH_FORMAT_CONTROLS |
|
UBLOCK_ELYMAIC |
|
UBLOCK_NANDINAGARI |
|
UBLOCK_NYIAKENG_PUACHUE_HMONG |
|
UBLOCK_OTTOMAN_SIYAQ_NUMBERS |
|
UBLOCK_SMALL_KANA_EXTENSION |
|
UBLOCK_SYMBOLS_AND_PICTOGRAPHS_EXTENDED_A |
|
UBLOCK_TAMIL_SUPPLEMENT |
|
UBLOCK_WANCHO |
|
UBLOCK_CHORASMIAN |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_G |
|
UBLOCK_DIVES_AKURU |
|
UBLOCK_KHITAN_SMALL_SCRIPT |
|
UBLOCK_LISU_SUPPLEMENT |
|
UBLOCK_SYMBOLS_FOR_LEGACY_COMPUTING |
|
UBLOCK_TANGUT_SUPPLEMENT |
|
UBLOCK_YEZIDI |
|
UBLOCK_ARABIC_EXTENDED_B |
|
UBLOCK_CYPRO_MINOAN |
|
UBLOCK_ETHIOPIC_EXTENDED_B |
|
UBLOCK_KANA_EXTENDED_B |
|
UBLOCK_LATIN_EXTENDED_F |
|
UBLOCK_LATIN_EXTENDED_G |
|
UBLOCK_OLD_UYGHUR |
|
UBLOCK_TANGSA |
|
UBLOCK_TOTO |
|
UBLOCK_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS_EXTENDED_A |
|
UBLOCK_VITHKUQI |
|
UBLOCK_ZNAMENNY_MUSICAL_NOTATION |
|
UBLOCK_ARABIC_EXTENDED_C |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_H |
|
UBLOCK_CYRILLIC_EXTENDED_D |
|
UBLOCK_DEVANAGARI_EXTENDED_A |
|
UBLOCK_KAKTOVIK_NUMERALS |
|
UBLOCK_KAWI |
|
UBLOCK_NAG_MUNDARI |
|
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_I |
|
UBLOCK_EGYPTIAN_HIEROGLYPHS_EXTENDED_A |
|
UBLOCK_GARAY |
|
UBLOCK_GURUNG_KHEMA |
|
UBLOCK_KIRAT_RAI |
|
UBLOCK_MYANMAR_EXTENDED_C |
|
UBLOCK_OL_ONAL |
|
UBLOCK_SUNUWAR |
|
UBLOCK_SYMBOLS_FOR_LEGACY_COMPUTING_SUPPLEMENT |
|
UBLOCK_TODHRI |
|
UBLOCK_TULU_TIGALARI |
|
UBLOCK_COUNT | One more than the highest normal UBlockCode value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_BLOCK).
|
UBLOCK_INVALID_CODE |
|
enum UCharCategory |
Data for enumerated Unicode general category types.
See http://www.unicode.org/Public/UNIDATA/UnicodeData.html .
Enumerator | |
---|---|
U_UNASSIGNED | Non-category for unassigned and non-character code points.
|
U_GENERAL_OTHER_TYPES | Cn "Other, Not Assigned (no characters in [UnicodeData.txt] have this property)" (same as U_UNASSIGNED!)
|
U_UPPERCASE_LETTER | Lu.
|
U_LOWERCASE_LETTER | Ll.
|
U_TITLECASE_LETTER | Lt.
|
U_MODIFIER_LETTER | Lm.
|
U_OTHER_LETTER | Lo.
|
U_NON_SPACING_MARK | Mn.
|
U_ENCLOSING_MARK | Me.
|
U_COMBINING_SPACING_MARK | Mc.
|
U_DECIMAL_DIGIT_NUMBER | Nd.
|
U_LETTER_NUMBER | Nl.
|
U_OTHER_NUMBER | No.
|
U_SPACE_SEPARATOR | Zs.
|
U_LINE_SEPARATOR | Zl.
|
U_PARAGRAPH_SEPARATOR | Zp.
|
U_CONTROL_CHAR | Cc.
|
U_FORMAT_CHAR | Cf.
|
U_PRIVATE_USE_CHAR | Co.
|
U_SURROGATE | Cs.
|
U_DASH_PUNCTUATION | Pd.
|
U_START_PUNCTUATION | Ps.
|
U_END_PUNCTUATION | Pe.
|
U_CONNECTOR_PUNCTUATION | Pc.
|
U_OTHER_PUNCTUATION | Po.
|
U_MATH_SYMBOL | Sm.
|
U_CURRENCY_SYMBOL | Sc.
|
U_MODIFIER_SYMBOL | Sk.
|
U_OTHER_SYMBOL | So.
|
U_INITIAL_PUNCTUATION | Pi.
|
U_FINAL_PUNCTUATION | Pf.
|
U_CHAR_CATEGORY_COUNT | One higher than the last enum UCharCategory constant. This numeric value is stable (will not change), see http://www.unicode.org/policies/stability_policy.html#Property_Value
|
enum UCharDirection |
This specifies the language directional property of a character set.
Enumerator | |
---|---|
U_LEFT_TO_RIGHT | L.
|
U_RIGHT_TO_LEFT | R.
|
U_EUROPEAN_NUMBER | EN.
|
U_EUROPEAN_NUMBER_SEPARATOR | ES.
|
U_EUROPEAN_NUMBER_TERMINATOR | ET.
|
U_ARABIC_NUMBER | AN.
|
U_COMMON_NUMBER_SEPARATOR | CS.
|
U_BLOCK_SEPARATOR | B.
|
U_SEGMENT_SEPARATOR | S.
|
U_WHITE_SPACE_NEUTRAL | WS.
|
U_OTHER_NEUTRAL | ON.
|
U_LEFT_TO_RIGHT_EMBEDDING | LRE.
|
U_LEFT_TO_RIGHT_OVERRIDE | LRO.
|
U_RIGHT_TO_LEFT_ARABIC | AL.
|
U_RIGHT_TO_LEFT_EMBEDDING | RLE.
|
U_RIGHT_TO_LEFT_OVERRIDE | RLO.
|
U_POP_DIRECTIONAL_FORMAT | PDF.
|
U_DIR_NON_SPACING_MARK | NSM.
|
U_BOUNDARY_NEUTRAL | BN.
|
U_FIRST_STRONG_ISOLATE | FSI.
|
U_LEFT_TO_RIGHT_ISOLATE | LRI.
|
U_RIGHT_TO_LEFT_ISOLATE | RLI.
|
U_POP_DIRECTIONAL_ISOLATE | PDI.
|
U_CHAR_DIRECTION_COUNT | One more than the highest UCharDirection value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_BIDI_CLASS).
|
enum UCharNameChoice |
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.
Enumerator | |
---|---|
U_UNICODE_CHAR_NAME | Unicode character name (Name property).
|
U_UNICODE_10_CHAR_NAME | The Unicode_1_Name property value which is of little practical value. Beginning with ICU 49, ICU APIs return an empty string for this name choice.
|
U_EXTENDED_CHAR_NAME | Standard or synthetic character name.
|
U_CHAR_NAME_ALIAS | Corrected name from NameAliases.txt.
|
U_CHAR_NAME_CHOICE_COUNT | One more than the highest normal UCharNameChoice value.
|
enum UDecompositionType |
Decomposition Type constants.
Enumerator | |
---|---|
U_DT_COUNT | One more than the highest normal UDecompositionType value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_DECOMPOSITION_TYPE).
|
enum UEastAsianWidth |
East Asian Width constants.
Enumerator | |
---|---|
U_EA_COUNT | One more than the highest normal UEastAsianWidth value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_EAST_ASIAN_WIDTH).
|
Grapheme Cluster Break constants.
Enumerator | |
---|---|
U_GCB_SPACING_MARK |
|
U_GCB_PREPEND |
|
U_GCB_REGIONAL_INDICATOR |
|
U_GCB_E_BASE |
|
U_GCB_E_BASE_GAZ |
|
U_GCB_E_MODIFIER |
|
U_GCB_GLUE_AFTER_ZWJ |
|
U_GCB_ZWJ |
|
U_GCB_COUNT | One more than the highest normal UGraphemeClusterBreak value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_GRAPHEME_CLUSTER_BREAK).
|
enum UHangulSyllableType |
Hangul Syllable Type constants.
Enumerator | |
---|---|
U_HST_COUNT | One more than the highest normal UHangulSyllableType value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_HANGUL_SYLLABLE_TYPE).
|
enum UIdentifierStatus |
Identifier Status constants.
See https://www.unicode.org/reports/tr39/#Identifier_Status_and_Type.
Enumerator | |
---|---|
U_ID_STATUS_RESTRICTED |
|
U_ID_STATUS_ALLOWED |
|
enum UIdentifierType |
Identifier Type constants.
See https://www.unicode.org/reports/tr39/#Identifier_Status_and_Type.
Enumerator | |
---|---|
U_ID_TYPE_NOT_CHARACTER |
|
U_ID_TYPE_DEPRECATED |
|
U_ID_TYPE_DEFAULT_IGNORABLE |
|
U_ID_TYPE_NOT_NFKC |
|
U_ID_TYPE_NOT_XID |
|
U_ID_TYPE_EXCLUSION |
|
U_ID_TYPE_OBSOLETE |
|
U_ID_TYPE_TECHNICAL |
|
U_ID_TYPE_UNCOMMON_USE |
|
U_ID_TYPE_LIMITED_USE |
|
U_ID_TYPE_INCLUSION |
|
U_ID_TYPE_RECOMMENDED |
|
enum UIndicConjunctBreak |
Indic Conjunct Break constants.
Enumerator | |
---|---|
U_INCB_NONE |
|
U_INCB_CONSONANT |
|
U_INCB_EXTEND |
|
U_INCB_LINKER |
|
Indic Positional Category constants.
Enumerator | |
---|---|
U_INPC_NA |
|
U_INPC_BOTTOM |
|
U_INPC_BOTTOM_AND_LEFT |
|
U_INPC_BOTTOM_AND_RIGHT |
|
U_INPC_LEFT |
|
U_INPC_LEFT_AND_RIGHT |
|
U_INPC_OVERSTRUCK |
|
U_INPC_RIGHT |
|
U_INPC_TOP |
|
U_INPC_TOP_AND_BOTTOM |
|
U_INPC_TOP_AND_BOTTOM_AND_RIGHT |
|
U_INPC_TOP_AND_LEFT |
|
U_INPC_TOP_AND_LEFT_AND_RIGHT |
|
U_INPC_TOP_AND_RIGHT |
|
U_INPC_VISUAL_ORDER_LEFT |
|
U_INPC_TOP_AND_BOTTOM_AND_LEFT |
|
Indic Syllabic Category constants.
Enumerator | |
---|---|
U_INSC_OTHER |
|
U_INSC_AVAGRAHA |
|
U_INSC_BINDU |
|
U_INSC_BRAHMI_JOINING_NUMBER |
|
U_INSC_CANTILLATION_MARK |
|
U_INSC_CONSONANT |
|
U_INSC_CONSONANT_DEAD |
|
U_INSC_CONSONANT_FINAL |
|
U_INSC_CONSONANT_HEAD_LETTER |
|
U_INSC_CONSONANT_INITIAL_POSTFIXED |
|
U_INSC_CONSONANT_KILLER |
|
U_INSC_CONSONANT_MEDIAL |
|
U_INSC_CONSONANT_PLACEHOLDER |
|
U_INSC_CONSONANT_PRECEDING_REPHA |
|
U_INSC_CONSONANT_PREFIXED |
|
U_INSC_CONSONANT_SUBJOINED |
|
U_INSC_CONSONANT_SUCCEEDING_REPHA |
|
U_INSC_CONSONANT_WITH_STACKER |
|
U_INSC_GEMINATION_MARK |
|
U_INSC_INVISIBLE_STACKER |
|
U_INSC_JOINER |
|
U_INSC_MODIFYING_LETTER |
|
U_INSC_NON_JOINER |
|
U_INSC_NUKTA |
|
U_INSC_NUMBER |
|
U_INSC_NUMBER_JOINER |
|
U_INSC_PURE_KILLER |
|
U_INSC_REGISTER_SHIFTER |
|
U_INSC_SYLLABLE_MODIFIER |
|
U_INSC_TONE_LETTER |
|
U_INSC_TONE_MARK |
|
U_INSC_VIRAMA |
|
U_INSC_VISARGA |
|
U_INSC_VOWEL |
|
U_INSC_VOWEL_DEPENDENT |
|
U_INSC_VOWEL_INDEPENDENT |
|
U_INSC_REORDERING_KILLER |
|
enum UJoiningGroup |
Joining Group constants.
Enumerator | |
---|---|
U_JG_TEH_MARBUTA_GOAL |
|
U_JG_FE |
|
U_JG_KHAPH |
|
U_JG_ZHAIN |
|
U_JG_BURUSHASKI_YEH_BARREE |
|
U_JG_FARSI_YEH |
|
U_JG_NYA |
|
U_JG_ROHINGYA_YEH |
|
U_JG_MANICHAEAN_ALEPH |
|
U_JG_MANICHAEAN_AYIN |
|
U_JG_MANICHAEAN_BETH |
|
U_JG_MANICHAEAN_DALETH |
|
U_JG_MANICHAEAN_DHAMEDH |
|
U_JG_MANICHAEAN_FIVE |
|
U_JG_MANICHAEAN_GIMEL |
|
U_JG_MANICHAEAN_HETH |
|
U_JG_MANICHAEAN_HUNDRED |
|
U_JG_MANICHAEAN_KAPH |
|
U_JG_MANICHAEAN_LAMEDH |
|
U_JG_MANICHAEAN_MEM |
|
U_JG_MANICHAEAN_NUN |
|
U_JG_MANICHAEAN_ONE |
|
U_JG_MANICHAEAN_PE |
|
U_JG_MANICHAEAN_QOPH |
|
U_JG_MANICHAEAN_RESH |
|
U_JG_MANICHAEAN_SADHE |
|
U_JG_MANICHAEAN_SAMEKH |
|
U_JG_MANICHAEAN_TAW |
|
U_JG_MANICHAEAN_TEN |
|
U_JG_MANICHAEAN_TETH |
|
U_JG_MANICHAEAN_THAMEDH |
|
U_JG_MANICHAEAN_TWENTY |
|
U_JG_MANICHAEAN_WAW |
|
U_JG_MANICHAEAN_YODH |
|
U_JG_MANICHAEAN_ZAYIN |
|
U_JG_STRAIGHT_WAW |
|
U_JG_AFRICAN_FEH |
|
U_JG_AFRICAN_NOON |
|
U_JG_AFRICAN_QAF |
|
U_JG_MALAYALAM_BHA |
|
U_JG_MALAYALAM_JA |
|
U_JG_MALAYALAM_LLA |
|
U_JG_MALAYALAM_LLLA |
|
U_JG_MALAYALAM_NGA |
|
U_JG_MALAYALAM_NNA |
|
U_JG_MALAYALAM_NNNA |
|
U_JG_MALAYALAM_NYA |
|
U_JG_MALAYALAM_RA |
|
U_JG_MALAYALAM_SSA |
|
U_JG_MALAYALAM_TTA |
|
U_JG_HANIFI_ROHINGYA_KINNA_YA |
|
U_JG_HANIFI_ROHINGYA_PA |
|
U_JG_THIN_YEH |
|
U_JG_VERTICAL_TAIL |
|
U_JG_KASHMIRI_YEH |
|
U_JG_COUNT | One more than the highest normal UJoiningGroup value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_JOINING_GROUP).
|
enum UJoiningType |
Joining Type constants.
Enumerator | |
---|---|
U_JT_COUNT | One more than the highest normal UJoiningType value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_JOINING_TYPE).
|
enum ULineBreak |
Line Break constants.
Enumerator | |
---|---|
U_LB_INSEPARABLE | Renamed from the misspelled "inseperable" in Unicode 4.0.1/ICU 3.0.
|
U_LB_NEXT_LINE |
|
U_LB_WORD_JOINER |
|
U_LB_H2 |
|
U_LB_H3 |
|
U_LB_JL |
|
U_LB_JT |
|
U_LB_JV |
|
U_LB_CLOSE_PARENTHESIS |
|
U_LB_CONDITIONAL_JAPANESE_STARTER |
|
U_LB_HEBREW_LETTER |
|
U_LB_REGIONAL_INDICATOR |
|
U_LB_E_BASE |
|
U_LB_E_MODIFIER |
|
U_LB_ZWJ |
|
U_LB_AKSARA |
|
U_LB_AKSARA_PREBASE |
|
U_LB_AKSARA_START |
|
U_LB_VIRAMA_FINAL |
|
U_LB_VIRAMA |
|
U_LB_COUNT | One more than the highest normal ULineBreak value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_LINE_BREAK).
|
enum UNumericType |
Numeric Type constants.
Enumerator | |
---|---|
U_NT_COUNT | One more than the highest normal UNumericType value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_NUMERIC_TYPE).
|
enum UProperty |
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 UAX #44: Unicode Character Database (http://www.unicode.org/reports/tr44/).
Important: If ICU is built with UCD files from Unicode versions below, e.g., 3.2, then properties marked with "new in Unicode 3.2" are not or not fully available. Check u_getUnicodeVersion to be sure.
Enumerator | |
---|---|
UCHAR_ALPHABETIC | Binary property Alphabetic. Same as u_isUAlphabetic, different from u_isalpha. Lu+Ll+Lt+Lm+Lo+Nl+Other_Alphabetic
|
UCHAR_BINARY_START | First constant for binary Unicode properties.
|
UCHAR_ASCII_HEX_DIGIT | Binary property ASCII_Hex_Digit. 0-9 A-F a-f
|
UCHAR_BIDI_CONTROL | Binary property Bidi_Control. Format controls which have specific functions in the Bidi Algorithm.
|
UCHAR_BIDI_MIRRORED | Binary property Bidi_Mirrored. Characters that may change display in RTL text. Same as u_isMirrored. See Bidi Algorithm, UTR 9.
|
UCHAR_DASH | Binary property Dash. Variations of dashes.
|
UCHAR_DEFAULT_IGNORABLE_CODE_POINT | 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)
|
UCHAR_DEPRECATED | Binary property Deprecated (new in Unicode 3.2). The usage of deprecated characters is strongly discouraged.
|
UCHAR_DIACRITIC | Binary property Diacritic. Characters that linguistically modify the meaning of another character to which they apply.
|
UCHAR_EXTENDER | Binary property Extender. Extend the value or shape of a preceding alphabetic character, e.g., length and iteration marks.
|
UCHAR_FULL_COMPOSITION_EXCLUSION | Binary property Full_Composition_Exclusion. CompositionExclusions.txt+Singleton Decompositions+ Non-Starter Decompositions.
|
UCHAR_GRAPHEME_BASE | 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
|
UCHAR_GRAPHEME_EXTEND | 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
|
UCHAR_GRAPHEME_LINK | Binary property Grapheme_Link (new in Unicode 3.2). For programmatic determination of grapheme cluster boundaries.
|
UCHAR_HEX_DIGIT | Binary property Hex_Digit. Characters commonly used for hexadecimal numbers.
|
UCHAR_HYPHEN | Binary property Hyphen. Dashes used to mark connections between pieces of words, plus the Katakana middle dot.
|
UCHAR_ID_CONTINUE | Binary property ID_Continue. Characters that can continue an identifier. DerivedCoreProperties.txt also says "NOTE: Cf characters should be filtered out." ID_Start+Mn+Mc+Nd+Pc
|
UCHAR_ID_START | Binary property ID_Start. Characters that can start an identifier. Lu+Ll+Lt+Lm+Lo+Nl
|
UCHAR_IDEOGRAPHIC | Binary property Ideographic. CJKV ideographs.
|
UCHAR_IDS_BINARY_OPERATOR | Binary property IDS_Binary_Operator (new in Unicode 3.2). For programmatic determination of Ideographic Description Sequences.
|
UCHAR_IDS_TRINARY_OPERATOR | Binary property IDS_Trinary_Operator (new in Unicode 3.2). For programmatic determination of Ideographic Description Sequences.
|
UCHAR_JOIN_CONTROL | Binary property Join_Control. Format controls for cursive joining and ligation.
|
UCHAR_LOGICAL_ORDER_EXCEPTION | Binary property Logical_Order_Exception (new in Unicode 3.2). Characters that do not use logical order and require special handling in most processing.
|
UCHAR_LOWERCASE | Binary property Lowercase. Same as u_isULowercase, different from u_islower. Ll+Other_Lowercase
|
UCHAR_MATH | Binary property Math. Sm+Other_Math
|
UCHAR_NONCHARACTER_CODE_POINT | Binary property Noncharacter_Code_Point. Code points that are explicitly defined as illegal for the encoding of characters.
|
UCHAR_QUOTATION_MARK | Binary property Quotation_Mark.
|
UCHAR_RADICAL | Binary property Radical (new in Unicode 3.2). For programmatic determination of Ideographic Description Sequences.
|
UCHAR_SOFT_DOTTED | 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.
|
UCHAR_TERMINAL_PUNCTUATION | Binary property Terminal_Punctuation. Punctuation characters that generally mark the end of textual units.
|
UCHAR_UNIFIED_IDEOGRAPH | Binary property Unified_Ideograph (new in Unicode 3.2). For programmatic determination of Ideographic Description Sequences.
|
UCHAR_UPPERCASE | Binary property Uppercase. Same as u_isUUppercase, different from u_isupper. Lu+Other_Uppercase
|
UCHAR_WHITE_SPACE | Binary property White_Space. Same as u_isUWhiteSpace, different from u_isspace and u_isWhitespace. Space characters+TAB+CR+LF-ZWSP-ZWNBSP
|
UCHAR_XID_CONTINUE | Binary property XID_Continue. ID_Continue modified to allow closure under normalization forms NFKC and NFKD.
|
UCHAR_XID_START | Binary property XID_Start. ID_Start modified to allow closure under normalization forms NFKC and NFKD.
|
UCHAR_CASE_SENSITIVE | Binary property Case_Sensitive. Either the source of a case mapping or in the target of a case mapping. Not the same as the general category Cased_Letter.
|
UCHAR_S_TERM | Binary property STerm (new in Unicode 4.0.1). Sentence Terminal. Used in UAX #29: Text Boundaries (http://www.unicode.org/reports/tr29/)
|
UCHAR_VARIATION_SELECTOR | Binary property Variation_Selector (new in Unicode 4.0.1). Indicates all those characters that qualify as Variation Selectors. For details on the behavior of these characters, see StandardizedVariants.html and 15.6 Variation Selectors.
|
UCHAR_NFD_INERT | Binary property NFD_Inert. ICU-specific property for characters that are inert under NFD, i.e., they do not interact with adjacent characters. See the documentation for the Normalizer2 class and the Normalizer2::isInert() method.
|
UCHAR_NFKD_INERT | Binary property NFKD_Inert. ICU-specific property for characters that are inert under NFKD, i.e., they do not interact with adjacent characters. See the documentation for the Normalizer2 class and the Normalizer2::isInert() method.
|
UCHAR_NFC_INERT | Binary property NFC_Inert. ICU-specific property for characters that are inert under NFC, i.e., they do not interact with adjacent characters. See the documentation for the Normalizer2 class and the Normalizer2::isInert() method.
|
UCHAR_NFKC_INERT | Binary property NFKC_Inert. ICU-specific property for characters that are inert under NFKC, i.e., they do not interact with adjacent characters. See the documentation for the Normalizer2 class and the Normalizer2::isInert() method.
|
UCHAR_SEGMENT_STARTER | Binary Property Segment_Starter. ICU-specific property for characters that are starters in terms of Unicode normalization and combining character sequences. They have ccc=0 and do not occur in non-initial position of the canonical decomposition of any character (like a-umlaut in NFD and a Jamo T in an NFD(Hangul LVT)). ICU uses this property for segmenting a string for generating a set of canonically equivalent strings, e.g. for canonical closure while processing collation tailoring rules.
|
UCHAR_PATTERN_SYNTAX | Binary property Pattern_Syntax (new in Unicode 4.1). See UAX #31 Identifier and Pattern Syntax (http://www.unicode.org/reports/tr31/)
|
UCHAR_PATTERN_WHITE_SPACE | Binary property Pattern_White_Space (new in Unicode 4.1). See UAX #31 Identifier and Pattern Syntax (http://www.unicode.org/reports/tr31/)
|
UCHAR_POSIX_ALNUM | Binary property alnum (a C/POSIX character class). Implemented according to the UTS #18 Annex C Standard Recommendation. See the uchar.h file documentation.
|
UCHAR_POSIX_BLANK | Binary property blank (a C/POSIX character class). Implemented according to the UTS #18 Annex C Standard Recommendation. See the uchar.h file documentation.
|
UCHAR_POSIX_GRAPH | Binary property graph (a C/POSIX character class). Implemented according to the UTS #18 Annex C Standard Recommendation. See the uchar.h file documentation.
|
UCHAR_POSIX_PRINT | Binary property print (a C/POSIX character class). Implemented according to the UTS #18 Annex C Standard Recommendation. See the uchar.h file documentation.
|
UCHAR_POSIX_XDIGIT | Binary property xdigit (a C/POSIX character class). Implemented according to the UTS #18 Annex C Standard Recommendation. See the uchar.h file documentation.
|
UCHAR_CASED | Binary property Cased. For Lowercase, Uppercase and Titlecase characters.
|
UCHAR_CASE_IGNORABLE | Binary property Case_Ignorable. Used in context-sensitive case mappings.
|
UCHAR_CHANGES_WHEN_LOWERCASED | Binary property Changes_When_Lowercased.
|
UCHAR_CHANGES_WHEN_UPPERCASED | Binary property Changes_When_Uppercased.
|
UCHAR_CHANGES_WHEN_TITLECASED | Binary property Changes_When_Titlecased.
|
UCHAR_CHANGES_WHEN_CASEFOLDED | Binary property Changes_When_Casefolded.
|
UCHAR_CHANGES_WHEN_CASEMAPPED | Binary property Changes_When_Casemapped.
|
UCHAR_CHANGES_WHEN_NFKC_CASEFOLDED | Binary property Changes_When_NFKC_Casefolded.
|
UCHAR_EMOJI | Binary property Emoji. See http://www.unicode.org/reports/tr51/#Emoji_Properties
|
UCHAR_EMOJI_PRESENTATION | Binary property Emoji_Presentation. See http://www.unicode.org/reports/tr51/#Emoji_Properties
|
UCHAR_EMOJI_MODIFIER | Binary property Emoji_Modifier. See http://www.unicode.org/reports/tr51/#Emoji_Properties
|
UCHAR_EMOJI_MODIFIER_BASE | Binary property Emoji_Modifier_Base. See http://www.unicode.org/reports/tr51/#Emoji_Properties
|
UCHAR_EMOJI_COMPONENT | Binary property Emoji_Component. See http://www.unicode.org/reports/tr51/#Emoji_Properties
|
UCHAR_REGIONAL_INDICATOR | Binary property Regional_Indicator.
|
UCHAR_PREPENDED_CONCATENATION_MARK | Binary property Prepended_Concatenation_Mark.
|
UCHAR_EXTENDED_PICTOGRAPHIC | Binary property Extended_Pictographic. See http://www.unicode.org/reports/tr51/#Emoji_Properties
|
UCHAR_BASIC_EMOJI | Binary property of strings Basic_Emoji. See https://www.unicode.org/reports/tr51/#Emoji_Sets
|
UCHAR_EMOJI_KEYCAP_SEQUENCE | Binary property of strings Emoji_Keycap_Sequence. See https://www.unicode.org/reports/tr51/#Emoji_Sets
|
UCHAR_RGI_EMOJI_MODIFIER_SEQUENCE | Binary property of strings RGI_Emoji_Modifier_Sequence. See https://www.unicode.org/reports/tr51/#Emoji_Sets
|
UCHAR_RGI_EMOJI_FLAG_SEQUENCE | Binary property of strings RGI_Emoji_Flag_Sequence. See https://www.unicode.org/reports/tr51/#Emoji_Sets
|
UCHAR_RGI_EMOJI_TAG_SEQUENCE | Binary property of strings RGI_Emoji_Tag_Sequence. See https://www.unicode.org/reports/tr51/#Emoji_Sets
|
UCHAR_RGI_EMOJI_ZWJ_SEQUENCE | Binary property of strings RGI_Emoji_ZWJ_Sequence. See https://www.unicode.org/reports/tr51/#Emoji_Sets
|
UCHAR_RGI_EMOJI | Binary property of strings RGI_Emoji. See https://www.unicode.org/reports/tr51/#Emoji_Sets
|
UCHAR_IDS_UNARY_OPERATOR | Binary property IDS_Unary_Operator. For programmatic determination of Ideographic Description Sequences.
|
UCHAR_ID_COMPAT_MATH_START | Binary property ID_Compat_Math_Start. Used in mathematical identifier profile in UAX #31.
|
UCHAR_ID_COMPAT_MATH_CONTINUE | Binary property ID_Compat_Math_Continue. Used in mathematical identifier profile in UAX #31.
|
UCHAR_MODIFIER_COMBINING_MARK | Binary property Modifier_Combining_Mark. Used by the AMTRA algorithm in UAX #53.
|
UCHAR_BINARY_LIMIT | One more than the last constant for binary Unicode properties.
|
UCHAR_BIDI_CLASS | Enumerated property Bidi_Class. Same as u_charDirection, returns UCharDirection values.
|
UCHAR_INT_START | First constant for enumerated/integer Unicode properties.
|
UCHAR_BLOCK | Enumerated property Block. Same as ublock_getCode, returns UBlockCode values.
|
UCHAR_CANONICAL_COMBINING_CLASS | Enumerated property Canonical_Combining_Class. Same as u_getCombiningClass, returns 8-bit numeric values.
|
UCHAR_DECOMPOSITION_TYPE | Enumerated property Decomposition_Type. Returns UDecompositionType values.
|
UCHAR_EAST_ASIAN_WIDTH | Enumerated property East_Asian_Width. See http://www.unicode.org/reports/tr11/ Returns UEastAsianWidth values.
|
UCHAR_GENERAL_CATEGORY | Enumerated property General_Category. Same as u_charType, returns UCharCategory values.
|
UCHAR_JOINING_GROUP | Enumerated property Joining_Group. Returns UJoiningGroup values.
|
UCHAR_JOINING_TYPE | Enumerated property Joining_Type. Returns UJoiningType values.
|
UCHAR_LINE_BREAK | Enumerated property Line_Break. Returns ULineBreak values.
|
UCHAR_NUMERIC_TYPE | Enumerated property Numeric_Type. Returns UNumericType values.
|
UCHAR_SCRIPT | Enumerated property Script. Same as uscript_getScript, returns UScriptCode values.
|
UCHAR_HANGUL_SYLLABLE_TYPE | Enumerated property Hangul_Syllable_Type, new in Unicode 4. Returns UHangulSyllableType values.
|
UCHAR_NFD_QUICK_CHECK | Enumerated property NFD_Quick_Check. Returns UNormalizationCheckResult values.
|
UCHAR_NFKD_QUICK_CHECK | Enumerated property NFKD_Quick_Check. Returns UNormalizationCheckResult values.
|
UCHAR_NFC_QUICK_CHECK | Enumerated property NFC_Quick_Check. Returns UNormalizationCheckResult values.
|
UCHAR_NFKC_QUICK_CHECK | Enumerated property NFKC_Quick_Check. Returns UNormalizationCheckResult values.
|
UCHAR_LEAD_CANONICAL_COMBINING_CLASS | Enumerated property Lead_Canonical_Combining_Class. ICU-specific property for the ccc of the first code point of the decomposition, or lccc(c)=ccc(NFD(c)[0]). Useful for checking for canonically ordered text; see UNORM_FCD and http://www.unicode.org/notes/tn5/#FCD . Returns 8-bit numeric values like UCHAR_CANONICAL_COMBINING_CLASS.
|
UCHAR_TRAIL_CANONICAL_COMBINING_CLASS | Enumerated property Trail_Canonical_Combining_Class. ICU-specific property for the ccc of the last code point of the decomposition, or tccc(c)=ccc(NFD(c)[last]). Useful for checking for canonically ordered text; see UNORM_FCD and http://www.unicode.org/notes/tn5/#FCD . Returns 8-bit numeric values like UCHAR_CANONICAL_COMBINING_CLASS.
|
UCHAR_GRAPHEME_CLUSTER_BREAK | Enumerated property Grapheme_Cluster_Break (new in Unicode 4.1). Used in UAX #29: Text Boundaries (http://www.unicode.org/reports/tr29/) Returns UGraphemeClusterBreak values.
|
UCHAR_SENTENCE_BREAK | Enumerated property Sentence_Break (new in Unicode 4.1). Used in UAX #29: Text Boundaries (http://www.unicode.org/reports/tr29/) Returns USentenceBreak values.
|
UCHAR_WORD_BREAK | Enumerated property Word_Break (new in Unicode 4.1). Used in UAX #29: Text Boundaries (http://www.unicode.org/reports/tr29/) Returns UWordBreakValues values.
|
UCHAR_BIDI_PAIRED_BRACKET_TYPE | Enumerated property Bidi_Paired_Bracket_Type (new in Unicode 6.3). Used in UAX #9: Unicode Bidirectional Algorithm (http://www.unicode.org/reports/tr9/) Returns UBidiPairedBracketType values.
|
UCHAR_INDIC_POSITIONAL_CATEGORY | Enumerated property Indic_Positional_Category. New in Unicode 6.0 as provisional property Indic_Matra_Category; renamed and changed to informative in Unicode 8.0. See http://www.unicode.org/reports/tr44/#IndicPositionalCategory.txt
|
UCHAR_INDIC_SYLLABIC_CATEGORY | Enumerated property Indic_Syllabic_Category. New in Unicode 6.0 as provisional; informative since Unicode 8.0. See http://www.unicode.org/reports/tr44/#IndicSyllabicCategory.txt
|
UCHAR_VERTICAL_ORIENTATION | Enumerated property Vertical_Orientation. Used for UAX #50 Unicode Vertical Text Layout (https://www.unicode.org/reports/tr50/). New as a UCD property in Unicode 10.0.
|
UCHAR_IDENTIFIER_STATUS | Enumerated property Identifier_Status. Used for UTS #39 General Security Profile for Identifiers (https://www.unicode.org/reports/tr39/#General_Security_Profile).
|
UCHAR_INDIC_CONJUNCT_BREAK | Enumerated property Indic_Conjunct_Break. Used in the grapheme cluster break algorithm in UAX #29.
|
UCHAR_INT_LIMIT | One more than the last constant for enumerated/integer Unicode properties.
|
UCHAR_GENERAL_CATEGORY_MASK | Bitmask property General_Category_Mask. This is the General_Category property returned as a bit mask. When used in u_getIntPropertyValue(c), same as U_MASK(u_charType(c)), returns bit masks for UCharCategory values where exactly one bit is set. When used with u_getPropertyValueName() and u_getPropertyValueEnum(), a multi-bit mask is used for sets of categories like "Letters". Mask values should be cast to uint32_t.
|
UCHAR_MASK_START | First constant for bit-mask Unicode properties.
|
UCHAR_MASK_LIMIT | One more than the last constant for bit-mask Unicode properties.
|
UCHAR_NUMERIC_VALUE | Double property Numeric_Value. Corresponds to u_getNumericValue.
|
UCHAR_DOUBLE_START | First constant for double Unicode properties.
|
UCHAR_DOUBLE_LIMIT | One more than the last constant for double Unicode properties.
|
UCHAR_AGE | String property Age. Corresponds to u_charAge.
|
UCHAR_STRING_START | First constant for string Unicode properties.
|
UCHAR_BIDI_MIRRORING_GLYPH | String property Bidi_Mirroring_Glyph. Corresponds to u_charMirror.
|
UCHAR_CASE_FOLDING | String property Case_Folding. Corresponds to u_strFoldCase in ustring.h.
|
UCHAR_ISO_COMMENT | Deprecated string property ISO_Comment. Corresponds to u_getISOComment.
|
UCHAR_LOWERCASE_MAPPING | String property Lowercase_Mapping. Corresponds to u_strToLower in ustring.h.
|
UCHAR_NAME | String property Name. Corresponds to u_charName.
|
UCHAR_SIMPLE_CASE_FOLDING | String property Simple_Case_Folding. Corresponds to u_foldCase.
|
UCHAR_SIMPLE_LOWERCASE_MAPPING | String property Simple_Lowercase_Mapping. Corresponds to u_tolower.
|
UCHAR_SIMPLE_TITLECASE_MAPPING | String property Simple_Titlecase_Mapping. Corresponds to u_totitle.
|
UCHAR_SIMPLE_UPPERCASE_MAPPING | String property Simple_Uppercase_Mapping. Corresponds to u_toupper.
|
UCHAR_TITLECASE_MAPPING | String property Titlecase_Mapping. Corresponds to u_strToTitle in ustring.h.
|
UCHAR_UNICODE_1_NAME | String property Unicode_1_Name. This property is of little practical value. Beginning with ICU 49, ICU APIs return an empty string for this property. Corresponds to u_charName(U_UNICODE_10_CHAR_NAME).
|
UCHAR_UPPERCASE_MAPPING | String property Uppercase_Mapping. Corresponds to u_strToUpper in ustring.h.
|
UCHAR_BIDI_PAIRED_BRACKET | String property Bidi_Paired_Bracket (new in Unicode 6.3). Corresponds to u_getBidiPairedBracket.
|
UCHAR_STRING_LIMIT | One more than the last constant for string Unicode properties.
|
UCHAR_SCRIPT_EXTENSIONS | Miscellaneous property Script_Extensions (new in Unicode 6.0). Some characters are commonly used in multiple scripts. For more information, see UAX #24: http://www.unicode.org/reports/tr24/. Corresponds to uscript_hasScript and uscript_getScriptExtensions in uscript.h.
|
UCHAR_OTHER_PROPERTY_START | First constant for Unicode properties with unusual value types.
|
UCHAR_IDENTIFIER_TYPE | Miscellaneous property Identifier_Type. Used for UTS #39 General Security Profile for Identifiers (https://www.unicode.org/reports/tr39/#General_Security_Profile). Corresponds to u_hasIDType() and u_getIDTypes(). Each code point maps to a set of UIdentifierType values.
|
UCHAR_OTHER_PROPERTY_LIMIT | One more than the last constant for Unicode properties with unusual value types.
|
UCHAR_INVALID_CODE | Represents a nonexistent or invalid property or property value.
|
enum UPropertyNameChoice |
Selector constants for u_getPropertyName() and u_getPropertyValueName().
These selectors are used to choose which name is returned for a given property or value. All properties and values have a long name. Most have a short name, but some do not. Unicode allows for additional names, beyond the long and short name, which would be indicated by U_LONG_PROPERTY_NAME + i, where i=1, 2,...
Enumerator | |
---|---|
U_PROPERTY_NAME_CHOICE_COUNT | One more than the highest normal UPropertyNameChoice value.
|
enum USentenceBreak |
Sentence Break constants.
Enumerator | |
---|---|
U_SB_COUNT | One more than the highest normal USentenceBreak value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_SENTENCE_BREAK).
|
enum UVerticalOrientation |
enum UWordBreakValues |
Word Break constants.
(UWordBreak is a pre-existing enum type in ubrk.h for word break status tags.)
Enumerator | |
---|---|
U_WB_CR |
|
U_WB_EXTEND |
|
U_WB_LF |
|
U_WB_MIDNUMLET |
|
U_WB_NEWLINE |
|
U_WB_REGIONAL_INDICATOR |
|
U_WB_HEBREW_LETTER |
|
U_WB_SINGLE_QUOTE |
|
U_WB_DOUBLE_QUOTE |
|
U_WB_E_BASE |
|
U_WB_E_BASE_GAZ |
|
U_WB_E_MODIFIER |
|
U_WB_GLUE_AFTER_ZWJ |
|
U_WB_ZWJ |
|
U_WB_WSEGSPACE |
|
U_WB_COUNT | One more than the highest normal UWordBreakValues value. The highest value is available via u_getIntPropertyMaxValue(UCHAR_WORD_BREAK).
|
U_CAPI void u_charAge | ( | UChar32 | c, |
UVersionInfo | versionArray | ||
) |
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.
c | The code point. |
versionArray | The Unicode version number array, to be filled in. |
Returns the decimal digit value of a decimal digit character.
Such characters have the general category "Nd" (decimal digit numbers) and a Numeric_Type of Decimal.
Unlike ICU releases before 2.6, no digit values are returned for any Han characters because Han number characters are often used with a special Chinese-style number format (with characters for powers of 10 in between) instead of in decimal-positional notation. Unicode 4 explicitly assigns Han number characters the Numeric_Type Numeric instead of Decimal. See Jitterbug 1483 for more details.
Use u_getIntPropertyValue(c, UCHAR_NUMERIC_TYPE) and u_getNumericValue() for complete numeric Unicode properties.
c | the code point for which to get the decimal digit value |
Referenced by icu::DecimalFormatSymbols::setSymbol().
U_CAPI UCharDirection u_charDirection | ( | UChar32 | c | ) |
Returns the bidirectional category value for the code point, which is used in the Unicode bidirectional algorithm (UAX #9 http://www.unicode.org/reports/tr9/).
Note that some unassigned code points have bidi values of R or AL because they are in blocks that are reserved for Right-To-Left scripts.
Same as java.lang.Character.getDirectionality()
c | the code point to be tested |
U_CAPI UChar32 u_charFromName | ( | UCharNameChoice | nameChoice, |
const char * | name, | ||
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.
nameChoice | Selector for which name to match. |
name | The name to match. |
pErrorCode | Pointer to a UErrorCode variable |
Maps the specified character to a "mirror-image" character.
For characters with the Bidi_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 selection capabilities.
c | the code point to be mapped |
U_CAPI int32_t u_charName | ( | UChar32 | code, |
UCharNameChoice | nameChoice, | ||
char * | buffer, | ||
int32_t | 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 '-'. 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.
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. The name will always be zero-terminated. If there is no name, then the buffer will be set to the empty string. |
bufferLength | ==sizeof(buffer) |
pErrorCode | Pointer to a UErrorCode variable; check for U_SUCCESS() after u_charName() returns. |
Returns the general category value for the code point.
Same as java.lang.Character.getType().
c | the code point to be tested |
Returns the decimal digit value of the code point in the specified radix.
If the radix is not in the range 2<=radix<=36
or if the value of c
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:
'A'
through 'Z'
. In this case the value is c-'A'+10
. 'a'
through 'z'
. In this case the value is ch-'a'+10
. Same as java.lang.Character.digit().
ch | the code point to be tested. |
radix | the radix. |
U_CAPI void u_enumCharNames | ( | UChar32 | start, |
UChar32 | limit, | ||
UEnumCharNamesFn * | fn, | ||
void * | context, | ||
UCharNameChoice | nameChoice, | ||
UErrorCode * | pErrorCode | ||
) |
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.
start | The first code point in the enumeration range. |
limit | One more than the last code point in the enumeration range (the first one after the range). |
fn | The function that is to be called for each character name. |
context | An arbitrary pointer that is passed to the function. |
nameChoice | Selector for which kind of names to enumerate. |
pErrorCode | Pointer to a UErrorCode variable |
U_CAPI void u_enumCharTypes | ( | UCharEnumTypeRange * | enumRange, |
const void * | context | ||
) |
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.
enumRange | a pointer to a function that is called for each contiguous range of code points with the same general category |
context | an opaque pointer that is passed on to the callback function |
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.
This function only returns the simple, single-code point case mapping. Full case mappings should be used whenever possible because they produce better results by working on whole strings. They take into account the string context and the language and can map to a result string with a different length as appropriate. Full case mappings are applied by the string case mapping functions, see ustring.h and the UnicodeString class. See also the User Guide chapter on C/POSIX migration: https://unicode-org.github.io/icu/userguide/icu/posix#case-mappings
c | the code point to be mapped |
options | Either U_FOLD_CASE_DEFAULT or U_FOLD_CASE_EXCLUDE_SPECIAL_I |
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.
Same as java.lang.Character.forDigit().
digit | the number to convert to a character. |
radix | the radix. |
char
representation of the specified digit in the specified radix.Maps the specified character to its paired bracket character.
For Bidi_Paired_Bracket_Type!=None, this is the same as u_charMirror(). Otherwise c itself is returned. See http://www.unicode.org/reports/tr9/
c | the code point to be mapped |
U_CAPI const USet * u_getBinaryPropertySet | ( | UProperty | property, |
UErrorCode * | pErrorCode | ||
) |
Returns a frozen USet for a binary property.
The library retains ownership over the returned object. Sets an error code if the property number is not one for a binary property.
The returned set contains all code points for which the property is true.
property | UCHAR_BINARY_START..UCHAR_BINARY_LIMIT-1 |
pErrorCode | an in/out ICU UErrorCode |
Returns the combining class of the code point as specified in UnicodeData.txt.
c | the code point of the character |
U_CAPI int32_t u_getFC_NFKC_Closure | ( | UChar32 | c, |
UChar * | dest, | ||
int32_t | destCapacity, | ||
UErrorCode * | pErrorCode | ||
) |
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/
c | The character (code point) for which to get the FC_NFKC_Closure string. It must be 0<=c<=0x10ffff . |
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. |
destCapacity | ==sizeof(dest) |
pErrorCode | Pointer to a UErrorCode variable. |
U_CAPI int32_t u_getIDTypes | ( | UChar32 | c, |
UIdentifierType * | types, | ||
int32_t | capacity, | ||
UErrorCode * | pErrorCode | ||
) |
Writes code point c's Identifier_Type as a list of UIdentifierType values to the output types array and returns the number of types.
Used for UTS #39 General Security Profile for Identifiers (https://www.unicode.org/reports/tr39/#General_Security_Profile).
Each code point maps to a set of UIdentifierType values. There is always at least one type. The order of output values is undefined. Each type is output at most once; there cannot be more output values than UIdentifierType constants. In addition, only some of the types can be combined with others, and usually only a small number of types occur together. Future versions might add additional types. See UTS #39 and its data files for details.
If there are more than capacity types to be written, then U_BUFFER_OVERFLOW_ERROR is set and the number of types is returned. (Usual ICU buffer handling behavior.)
c | code point |
types | output array |
capacity | capacity of the array |
pErrorCode | Standard ICU error code. Its input value must pass the U_SUCCESS() test, or else the function returns immediately. Check for U_FAILURE() on output or use with function chaining. (See User Guide for details.) |
U_CAPI const UCPMap * u_getIntPropertyMap | ( | UProperty | property, |
UErrorCode * | pErrorCode | ||
) |
Returns an immutable UCPMap for an enumerated/catalog/int-valued property.
The library retains ownership over the returned object. Sets an error code if the property number is not one for an "int property".
The returned object maps all Unicode code points to their values for that property. For documentation of the integer values see u_getIntPropertyValue().
property | UCHAR_INT_START..UCHAR_INT_LIMIT-1 |
pErrorCode | an in/out ICU UErrorCode |
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):
For undefined UProperty constant values, min/max values will be 0/-1.
which | UProperty selector constant, identifies which binary property to check. Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT or UCHAR_INT_START<=which<UCHAR_INT_LIMIT. |
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.
which | UProperty selector constant, identifies which binary property to check. Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT or UCHAR_INT_START<=which<UCHAR_INT_LIMIT. |
Get the property value for an enumerated or integer Unicode property for a code point.
Also returns binary and mask 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);
c | Code point to test. |
which | UProperty selector constant, identifies which property to check. Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT or UCHAR_INT_START<=which<UCHAR_INT_LIMIT or UCHAR_MASK_START<=which<UCHAR_MASK_LIMIT. |
int32_t u_getISOComment | ( | UChar32 | c, |
char * | dest, | ||
int32_t | destCapacity, | ||
UErrorCode * | pErrorCode | ||
) |
Returns an empty string.
Used to return the ISO 10646 comment for a character. The Unicode ISO_Comment property is deprecated and has no values.
c | The character (code point) for which to get the ISO comment. It must be 0<=c<=0x10ffff . |
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. |
destCapacity | ==sizeof(dest) |
pErrorCode | Pointer to a UErrorCode variable; check for U_SUCCESS() after u_getISOComment() returns. |
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. Note: This is different from the Unicode Standard which specifies NaN as the default value. (NaN is not available on all platforms.)
Similar to java.lang.Character.getNumericValue(), but u_getNumericValue() also supports negative values, large values, and fractions, while Java's getNumericValue() returns values 10..35 for ASCII letters.
c | Code point to get the numeric value for. |
Return the UProperty enum for a given property name, as specified in the Unicode database file PropertyAliases.txt.
Short, long, and any other variants are recognized.
In addition, this function maps the synthetic names "gcm" / "General_Category_Mask" to the property UCHAR_GENERAL_CATEGORY_MASK. These names are not in PropertyAliases.txt.
alias | the property name to be matched. The name is compared using "loose matching" as described in PropertyAliases.txt. |
U_CAPI const char * u_getPropertyName | ( | UProperty | property, |
UPropertyNameChoice | nameChoice | ||
) |
Return the Unicode name for a given property, as given in the Unicode database file PropertyAliases.txt.
In addition, this function maps the property UCHAR_GENERAL_CATEGORY_MASK to the synthetic names "gcm" / "General_Category_Mask". These names are not in PropertyAliases.txt.
property | UProperty selector other than UCHAR_INVALID_CODE. If out of range, NULL is returned. |
nameChoice | selector for which name to get. If out of range, NULL is returned. All properties have a long name. Most have a short name, but some do not. Unicode allows for additional names; if present these will be returned by U_LONG_PROPERTY_NAME + i, where i=1, 2,... |
Return the property value integer for a given value name, as specified in the Unicode database file PropertyValueAliases.txt.
Short, long, and any other variants are recognized.
Note: Some of the names in PropertyValueAliases.txt will only be recognized with UCHAR_GENERAL_CATEGORY_MASK, not UCHAR_GENERAL_CATEGORY. These include: "C" / "Other", "L" / "Letter", "LC" / "Cased_Letter", "M" / "Mark", "N" / "Number", "P" / "Punctuation", "S" / "Symbol", and "Z" / "Separator".
property | UProperty selector constant. Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT or UCHAR_INT_START<=which<UCHAR_INT_LIMIT or UCHAR_MASK_START<=which<UCHAR_MASK_LIMIT. If out of range, UCHAR_INVALID_CODE is returned. |
alias | the value name to be matched. The name is compared using "loose matching" as described in PropertyValueAliases.txt. |
U_CAPI const char * u_getPropertyValueName | ( | UProperty | property, |
int32_t | value, | ||
UPropertyNameChoice | nameChoice | ||
) |
Return the Unicode name for a given property value, as given in the Unicode database file PropertyValueAliases.txt.
Note: Some of the names in PropertyValueAliases.txt can only be retrieved using UCHAR_GENERAL_CATEGORY_MASK, not UCHAR_GENERAL_CATEGORY. These include: "C" / "Other", "L" / "Letter", "LC" / "Cased_Letter", "M" / "Mark", "N" / "Number", "P" / "Punctuation", "S" / "Symbol", and "Z" / "Separator".
property | UProperty selector constant. Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT or UCHAR_INT_START<=which<UCHAR_INT_LIMIT or UCHAR_MASK_START<=which<UCHAR_MASK_LIMIT. If out of range, NULL is returned. |
value | selector for a value for the given property. If out of range, NULL is returned. In general, valid values range from 0 up to some maximum. There are a few exceptions: (1.) UCHAR_BLOCK values begin at the non-zero value UBLOCK_BASIC_LATIN. (2.) UCHAR_CANONICAL_COMBINING_CLASS values are not contiguous and range from 0..240. (3.) UCHAR_GENERAL_CATEGORY_MASK values are not values of UCharCategory, but rather mask values produced by U_GET_GC_MASK(). This allows grouped categories such as [:L:] to be represented. Mask values range non-contiguously from 1..U_GC_P_MASK. |
nameChoice | selector for which name to get. If out of range, NULL is returned. All values have a long name. Most have a short name, but some do not. Unicode allows for additional names; if present these will be returned by U_LONG_PROPERTY_NAME + i, where i=1, 2,... |
U_CAPI void u_getUnicodeVersion | ( | UVersionInfo | versionArray | ) |
Gets the Unicode version information.
The version array is filled in with the version information for the Unicode standard that is currently used by ICU. For example, Unicode version 3.1.1 is represented as an array with the values { 3, 1, 1, 0 }.
versionArray | an output array that will be filled in with the Unicode version number |
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/ucd/ . 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.
c | Code point to test. |
which | UProperty selector constant, identifies which binary property to check. Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT. |
U_CAPI bool u_hasIDType | ( | UChar32 | c, |
UIdentifierType | type | ||
) |
Does the set of Identifier_Type values code point c contain the given type?
Used for UTS #39 General Security Profile for Identifiers (https://www.unicode.org/reports/tr39/#General_Security_Profile).
Each code point maps to a set of UIdentifierType values.
c | code point |
type | Identifier_Type to check |
Determines whether the specified code point is an alphanumeric character (letter or digit) according to Java.
True for characters with general categories "L" (letters) and "Nd" (decimal digit numbers).
Same as java.lang.Character.isLetterOrDigit().
In addition to being equivalent to a Java function, this also serves as a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Determines whether the specified code point is a letter character.
True for general categories "L" (letters).
Same as java.lang.Character.isLetter().
In addition to being equivalent to a Java function, this also serves as a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Non-standard: Determines whether the specified code point is a base character.
True for general categories "L" (letters), "N" (numbers), "Mc" (spacing combining marks), and "Me" (enclosing marks).
Note that this is different from the Unicode Standard definition in chapter 3.6, conformance clause D51 “Base character”, which defines base characters as the code points with general categories Letter (L), Number (N), Punctuation (P), Symbol (S), or Space Separator (Zs).
c | the code point to be tested |
Determines whether the specified code point is a "blank" or "horizontal space", a character that visibly separates words on a line.
The following are equivalent definitions:
true for Unicode White_Space characters except for "vertical space controls" where "vertical space controls" are the following characters: U+000A (LF) U+000B (VT) U+000C (FF) U+000D (CR) U+0085 (NEL) U+2028 (LS) U+2029 (PS)
same as
true for U+0009 (TAB) and characters with general category "Zs" (space separators).
Note: There are several ICU whitespace functions; please see the uchar.h file documentation for a detailed comparison.
This is a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Determines whether the specified code point is a control character (as defined by this function).
A control character is one of the following:
This is a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Determines whether the specified code point is "defined", which usually means that it is assigned a character.
True for general categories other than "Cn" (other, not assigned), i.e., true for all code points mentioned in UnicodeData.txt.
Note that non-character code points (e.g., U+FDD0) are not "defined" (they are Cn), but surrogate code points are "defined" (Cs).
Same as java.lang.Character.isDefined().
c | the code point to be tested |
Determines whether the specified code point is a digit character according to Java.
True for characters with general category "Nd" (decimal digit numbers). Beginning with Unicode 4, this is the same as testing for the Numeric_Type of Decimal.
Same as java.lang.Character.isDigit().
In addition to being equivalent to a Java function, this also serves as a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Determines whether the specified code point is a "graphic" character (printable, excluding spaces).
true for all characters except those with general categories "Cc" (control codes), "Cf" (format controls), "Cs" (surrogates), "Cn" (unassigned), and "Z" (separators).
This is a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Determines if the specified character should be regarded as an ignorable character in an identifier, according to Java.
True for characters with general category "Cf" (format controls) as well as non-whitespace ISO controls (U+0000..U+0008, U+000E..U+001B, U+007F..U+009F).
Same as java.lang.Character.isIdentifierIgnorable().
Note that Unicode just recommends to ignore Cf (format controls).
c | the code point to be tested |
Determines if the specified character is permissible as a non-initial character of an identifier according to UAX #31 Unicode Identifier and Pattern Syntax.
Same as Unicode ID_Continue (UCHAR_ID_CONTINUE).
c | the code point to be tested |
Determines if the specified character is permissible as the first character in an identifier according to UAX #31 Unicode Identifier and Pattern Syntax.
Same as Unicode ID_Start (UCHAR_ID_START).
c | the code point to be tested |
Determines whether the specified code point is an ISO control code.
True for U+0000..U+001f and U+007f..U+009f (general category "Cc").
Same as java.lang.Character.isISOControl().
c | the code point to be tested |
Determines if the specified character is permissible in a Java identifier.
In addition to u_isIDPart(c), true for characters with general category "Sc" (currency symbols).
Same as java.lang.Character.isJavaIdentifierPart().
c | the code point to be tested |
Determines if the specified character is permissible as the first character in a Java identifier.
In addition to u_isIDStart(c), true for characters with general categories "Sc" (currency symbols) and "Pc" (connecting punctuation).
Same as java.lang.Character.isJavaIdentifierStart().
c | the code point to be tested |
Determine if the specified code point is a space character according to Java.
True for characters with general categories "Z" (separators), which does not include control codes (e.g., TAB or Line Feed).
Same as java.lang.Character.isSpaceChar().
Note: There are several ICU whitespace functions; please see the uchar.h file documentation for a detailed comparison.
c | the code point to be tested |
Determines whether the specified code point has the general category "Ll" (lowercase letter).
Same as java.lang.Character.isLowerCase().
This misses some characters that are also lowercase but have a different general category value. In order to include those, use UCHAR_LOWERCASE.
In addition to being equivalent to a Java function, this also serves as a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Determines whether the code point has the Bidi_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.
Same as java.lang.Character.isMirrored(). Same as UCHAR_BIDI_MIRRORED
c | the code point to be tested |
Determines whether the specified code point is a printable character.
True for general categories other than "C" (controls).
This is a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Determines whether the specified code point is a punctuation character.
True for characters with general categories "P" (punctuation).
This is a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Determines if the specified character is a space character or not.
Note: There are several ICU whitespace functions; please see the uchar.h file documentation for a detailed comparison.
This is a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the character to be tested |
Determines whether the specified code point is a titlecase letter.
True for general category "Lt" (titlecase letter).
Same as java.lang.Character.isTitleCase().
c | the code point to be tested |
Check if a code point has the Alphabetic Unicode property.
Same as u_hasBinaryProperty(c, UCHAR_ALPHABETIC). This is different from u_isalpha!
c | Code point to test |
Check if a code point has the Lowercase Unicode property.
Same as u_hasBinaryProperty(c, UCHAR_LOWERCASE). This is different from u_islower!
c | Code point to test |
Determines whether the specified code point has the general category "Lu" (uppercase letter).
Same as java.lang.Character.isUpperCase().
This misses some characters that are also uppercase but have a different general category value. In order to include those, use UCHAR_UPPERCASE.
In addition to being equivalent to a Java function, this also serves as a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Check if a code point has the Uppercase Unicode property.
Same as u_hasBinaryProperty(c, UCHAR_UPPERCASE). This is different from u_isupper!
c | Code point to test |
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!
Note: There are several ICU whitespace functions; please see the uchar.h file documentation for a detailed comparison.
c | Code point to test |
Determines if the specified code point is a whitespace character according to Java/ICU.
A character is considered to be a Java whitespace character if and only if it satisfies one of the following criteria:
This API tries to sync with the semantics of Java's java.lang.Character.isWhitespace(), but it may not return the exact same results because of the Unicode version difference.
Note: Unicode 4.0.1 changed U+200B ZERO WIDTH SPACE from a Space Separator (Zs) to a Format Control (Cf). Since then, isWhitespace(0x200b) returns false. See http://www.unicode.org/versions/Unicode4.0.1/
Note: There are several ICU whitespace functions; please see the uchar.h file documentation for a detailed comparison.
c | the code point to be tested |
Determines whether the specified code point is a hexadecimal digit.
This is equivalent to u_digit(c, 16)>=0. True for characters with general category "Nd" (decimal digit numbers) as well as Latin letters a-f and A-F in both ASCII and Fullwidth ASCII. (That is, for letters with code points 0041..0046, 0061..0066, FF21..FF26, FF41..FF46.)
In order to narrow the definition of hexadecimal digits to only ASCII characters, use (c<=0x7f && u_isxdigit(c)).
This is a C/POSIX migration function. See the comments about C/POSIX character classification functions in the documentation at the top of this header file.
c | the code point to be tested |
Returns true if the property is true for the string.
Same as u_hasBinaryProperty(single code point, which) if the string contains exactly one code point.
Most properties apply only to single code points. UTS #51 Unicode Emoji defines several properties of strings.
s | String to test. |
length | Length of the string, or negative if NUL-terminated. |
which | UProperty selector constant, identifies which binary property to check. Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT. |
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.
Same as java.lang.Character.toLowerCase().
This function only returns the simple, single-code point case mapping. Full case mappings should be used whenever possible because they produce better results by working on whole strings. They take into account the string context and the language and can map to a result string with a different length as appropriate. Full case mappings are applied by the string case mapping functions, see ustring.h and the UnicodeString class. See also the User Guide chapter on C/POSIX migration: https://unicode-org.github.io/icu/userguide/icu/posix#case-mappings
c | the code point to be mapped |
The given character is mapped to its titlecase equivalent according to UnicodeData.txt; if none is defined, the character itself is returned.
Same as java.lang.Character.toTitleCase().
This function only returns the simple, single-code point case mapping. Full case mappings should be used whenever possible because they produce better results by working on whole strings. They take into account the string context and the language and can map to a result string with a different length as appropriate. Full case mappings are applied by the string case mapping functions, see ustring.h and the UnicodeString class. See also the User Guide chapter on C/POSIX migration: https://unicode-org.github.io/icu/userguide/icu/posix#case-mappings
c | the code point to be mapped |
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.
Same as java.lang.Character.toUpperCase().
This function only returns the simple, single-code point case mapping. Full case mappings should be used whenever possible because they produce better results by working on whole strings. They take into account the string context and the language and can map to a result string with a different length as appropriate. Full case mappings are applied by the string case mapping functions, see ustring.h and the UnicodeString class. See also the User Guide chapter on C/POSIX migration: https://unicode-org.github.io/icu/userguide/icu/posix#case-mappings
c | the code point to be mapped |
U_CAPI UBlockCode ublock_getCode | ( | UChar32 | c | ) |
Returns the Unicode allocation block that contains the character.
c | the code point to be tested |