Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Header Files   Compound Members   File Members  

uchar.h File Reference

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


Defines

#define U_UNICODE_VERSION

Typedefs

typedef enum UCharCategory UCharCategory
typedef enum UCharDirection UCharDirection
typedef enum UCharScript UCharScript
typedef enum UCellWidth UCellWidth
typedef enum UCharNameChoice UCharNameChoice

Enumerations

enum  UCharCategory { U_UNASSIGNED, U_UPPERCASE_LETTER, U_LOWERCASE_LETTER, U_TITLECASE_LETTER, U_MODIFIER_LETTER, U_OTHER_LETTER, U_NON_SPACING_MARK, U_ENCLOSING_MARK, U_COMBINING_SPACING_MARK, U_DECIMAL_DIGIT_NUMBER, U_LETTER_NUMBER, U_OTHER_NUMBER, U_SPACE_SEPARATOR, U_LINE_SEPARATOR, U_PARAGRAPH_SEPARATOR, U_CONTROL_CHAR, U_FORMAT_CHAR, U_PRIVATE_USE_CHAR, U_SURROGATE, U_DASH_PUNCTUATION, U_START_PUNCTUATION, U_END_PUNCTUATION, U_CONNECTOR_PUNCTUATION, U_OTHER_PUNCTUATION, U_MATH_SYMBOL, U_CURRENCY_SYMBOL, U_MODIFIER_SYMBOL, U_OTHER_SYMBOL, U_INITIAL_PUNCTUATION, U_FINAL_PUNCTUATION, U_GENERAL_OTHER_TYPES, U_CHAR_CATEGORY_COUNT }
Data for enumerated Unicode general category types. More...

enum  UCharDirection { U_LEFT_TO_RIGHT, U_RIGHT_TO_LEFT, U_EUROPEAN_NUMBER, U_EUROPEAN_NUMBER_SEPARATOR, U_EUROPEAN_NUMBER_TERMINATOR, U_ARABIC_NUMBER, U_COMMON_NUMBER_SEPARATOR, U_BLOCK_SEPARATOR, U_SEGMENT_SEPARATOR, U_WHITE_SPACE_NEUTRAL, U_OTHER_NEUTRAL, U_LEFT_TO_RIGHT_EMBEDDING, U_LEFT_TO_RIGHT_OVERRIDE, U_RIGHT_TO_LEFT_ARABIC, U_RIGHT_TO_LEFT_EMBEDDING, U_RIGHT_TO_LEFT_OVERRIDE, U_POP_DIRECTIONAL_FORMAT, U_DIR_NON_SPACING_MARK, U_BOUNDARY_NEUTRAL, U_CHAR_DIRECTION_COUNT }
This specifies the language directional property of a character set. More...

enum  UCharScript { U_BASIC_LATIN, U_LATIN_1_SUPPLEMENT, U_LATIN_EXTENDED_A, U_LATIN_EXTENDED_B, U_IPA_EXTENSIONS, U_SPACING_MODIFIER_LETTERS, U_COMBINING_DIACRITICAL_MARKS, U_GREEK, U_CYRILLIC, U_ARMENIAN, U_HEBREW, U_ARABIC, U_SYRIAC, U_THAANA, U_DEVANAGARI, U_BENGALI, U_GURMUKHI, U_GUJARATI, U_ORIYA, U_TAMIL, U_TELUGU, U_KANNADA, U_MALAYALAM, U_SINHALA, U_THAI, U_LAO, U_TIBETAN, U_MYANMAR, U_GEORGIAN, U_HANGUL_JAMO, U_ETHIOPIC, U_CHEROKEE, U_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS, U_OGHAM, U_RUNIC, U_KHMER, U_MONGOLIAN, U_LATIN_EXTENDED_ADDITIONAL, U_GREEK_EXTENDED, U_GENERAL_PUNCTUATION, U_SUPERSCRIPTS_AND_SUBSCRIPTS, U_CURRENCY_SYMBOLS, U_COMBINING_MARKS_FOR_SYMBOLS, U_LETTERLIKE_SYMBOLS, U_NUMBER_FORMS, U_ARROWS, U_MATHEMATICAL_OPERATORS, U_MISCELLANEOUS_TECHNICAL, U_CONTROL_PICTURES, U_OPTICAL_CHARACTER_RECOGNITION, U_ENCLOSED_ALPHANUMERICS, U_BOX_DRAWING, U_BLOCK_ELEMENTS, U_GEOMETRIC_SHAPES, U_MISCELLANEOUS_SYMBOLS, U_DINGBATS, U_BRAILLE_PATTERNS, U_CJK_RADICALS_SUPPLEMENT, U_KANGXI_RADICALS, U_IDEOGRAPHIC_DESCRIPTION_CHARACTERS, U_CJK_SYMBOLS_AND_PUNCTUATION, U_HIRAGANA, U_KATAKANA, U_BOPOMOFO, U_HANGUL_COMPATIBILITY_JAMO, U_KANBUN, U_BOPOMOFO_EXTENDED, U_ENCLOSED_CJK_LETTERS_AND_MONTHS, U_CJK_COMPATIBILITY, U_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A, U_CJK_UNIFIED_IDEOGRAPHS, U_YI_SYLLABLES, U_YI_RADICALS, U_HANGUL_SYLLABLES, U_HIGH_SURROGATES, U_HIGH_PRIVATE_USE_SURROGATES, U_LOW_SURROGATES, U_PRIVATE_USE_AREA, U_CJK_COMPATIBILITY_IDEOGRAPHS, U_ALPHABETIC_PRESENTATION_FORMS, U_ARABIC_PRESENTATION_FORMS_A, U_COMBINING_HALF_MARKS, U_CJK_COMPATIBILITY_FORMS, U_SMALL_FORM_VARIANTS, U_ARABIC_PRESENTATION_FORMS_B, U_SPECIALS, U_HALFWIDTH_AND_FULLWIDTH_FORMS, U_CHAR_SCRIPT_COUNT, U_NO_SCRIPT }
Generated from Unicode Data files. More...

enum  UCellWidth { U_ZERO_WIDTH, U_HALF_WIDTH, U_FULL_WIDTH, U_NEUTRAL_WIDTH, U_CELL_WIDTH_COUNT }
Values returned by the u_getCellWidth() function. More...

enum  UCharNameChoice { U_UNICODE_CHAR_NAME, U_UNICODE_10_CHAR_NAME, U_CHAR_NAME_CHOICE_COUNT }
Selector constants for u_charName(). More...


Functions

U_CAPI bool_t U_EXPORT2 u_islower (UChar c)
Determines whether the specified UChar is a lowercase character according to Unicode 2.1.2. More...

U_CAPI bool_t U_EXPORT2 u_isupper (UChar c)
Determines whether the specified character is an uppercase character according to Unicode 2.1.2. More...

U_CAPI bool_t U_EXPORT2 u_istitle (UChar c)
Determines whether the specified character is a titlecase character according to Unicode 2.1.2. More...

U_CAPI bool_t U_EXPORT2 u_isdigit (UChar c)
Determines whether the specified character is a digit according to Unicode 2.1.2. More...

U_CAPI bool_t U_EXPORT2 u_isalnum (UChar c)
Determines whether the specified character is an alphanumeric character (letter or digit)according to Unicode 2.1.2. More...

U_CAPI bool_t U_EXPORT2 u_isdefined (UChar c)
Determines whether the specified numeric value is actually a defined character according to Unicode 2.1.2. More...

U_CAPI bool_t U_EXPORT2 u_isalpha (UChar c)
Determines whether the specified character is a letter according to Unicode 2.1.2. More...

U_CAPI bool_t U_EXPORT2 u_isspace (UChar c)
Determines if the specified character is a space character or not. More...

U_CAPI bool_t U_EXPORT2 u_iscntrl (UChar c)
Determines whether the specified character is a control character or not. More...

U_CAPI bool_t U_EXPORT2 u_isprint (UChar c)
Determines whether the specified character is a printable character according to Unicode 2.1.2. More...

U_CAPI bool_t U_EXPORT2 u_isbase (UChar c)
Determines whether the specified character is of the base form according to Unicode 2.1.2. More...

U_CAPI UCharDirection U_EXPORT2 u_charDirection (UChar c)
Returns the linguistic direction property of a character. More...

U_CAPI uint16_t U_EXPORT2 u_charCellWidth (UChar c)
Returns a value indicating the display-cell width of the character when used in Asian text, according to the Unicode standard (see p. More...

U_CAPI int8_t U_EXPORT2 u_charType (UChar c)
Returns a value indicating a character category according to Unicode 2.1.2. More...

U_CAPI int32_t U_EXPORT2 u_charDigitValue (UChar c)
Retrives the decimal numeric value of a digit character. More...

U_CAPI UCharScript U_EXPORT2 u_charScript (UChar ch)
Returns the script associated with a character. More...

U_CAPI UTextOffset U_EXPORT2 u_charName (uint32_t code, UCharNameChoice nameChoice, char *buffer, UTextOffset bufferLength, UErrorCode *pErrorCode)
Retrieve the name of a Unicode character. More...

U_CAPI bool_t U_EXPORT2 u_isIDStart (UChar c)
A convenience method for determining if a Unicode character is allowed to start in a Unicode identifier. More...

U_CAPI bool_t U_EXPORT2 u_isIDPart (UChar c)
A convenience method for determining if a Unicode character may be part of a Unicode identifier other than the starting character. More...

U_CAPI bool_t U_EXPORT2 u_isIDIgnorable (UChar c)
A convenience method for determining if a Unicode character should be regarded as an ignorable character in a Unicode identifier. More...

U_CAPI bool_t U_EXPORT2 u_isJavaIDStart (UChar c)
A convenience method for determining if a Unicode character is allowed as the first character in a Java identifier. More...

U_CAPI bool_t U_EXPORT2 u_isJavaIDPart (UChar c)
A convenience method for determining if a Unicode character may be part of a Java identifier other than the starting character. More...

U_CAPI UChar U_EXPORT2 u_tolower (UChar c)
The given character is mapped to its lowercase equivalent according to Unicode 2.1.2; if the character has no lowercase equivalent, the character itself is returned. More...

U_CAPI UChar U_EXPORT2 u_toupper (UChar c)
The given character is mapped to its uppercase equivalent according to Unicode 2.1.2; if the character has no uppercase equivalent, the character itself is returned. More...

U_CAPI UChar U_EXPORT2 u_totitle (UChar c)
The given character is mapped to its titlecase equivalent according to Unicode 2.1.2. More...

U_CAPI void U_EXPORT2 u_getUnicodeVersion (UVersionInfo info)
Gets the Unicode version information. More...


Variables

UChar UCHAR_MIN_VALUE
The minimum value a UChar can have. More...

UChar UCHAR_MAX_VALUE
The maximum value a UChar can have. More...


Detailed Description

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

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


Define Documentation

#define U_UNICODE_VERSION ()


Typedef Documentation

typedef enum UCharCategory UCharCategory

typedef enum UCharDirection UCharDirection

typedef enum UCharScript UCharScript

typedef enum UCellWidth UCellWidth

typedef enum UCharNameChoice UCharNameChoice


Enumeration Type Documentation

enum UCharCategory

Data for enumerated Unicode general category types.

Draft:
Enumeration values:
U_UNASSIGNED  
U_UPPERCASE_LETTER  
U_LOWERCASE_LETTER  
U_TITLECASE_LETTER  
U_MODIFIER_LETTER  
U_OTHER_LETTER  
U_NON_SPACING_MARK  
U_ENCLOSING_MARK  
U_COMBINING_SPACING_MARK  
U_DECIMAL_DIGIT_NUMBER  
U_LETTER_NUMBER  
U_OTHER_NUMBER  
U_SPACE_SEPARATOR  
U_LINE_SEPARATOR  
U_PARAGRAPH_SEPARATOR  
U_CONTROL_CHAR  
U_FORMAT_CHAR  
U_PRIVATE_USE_CHAR  
U_SURROGATE  
U_DASH_PUNCTUATION  
U_START_PUNCTUATION  
U_END_PUNCTUATION  
U_CONNECTOR_PUNCTUATION  
U_OTHER_PUNCTUATION  
U_MATH_SYMBOL  
U_CURRENCY_SYMBOL  
U_MODIFIER_SYMBOL  
U_OTHER_SYMBOL  
U_INITIAL_PUNCTUATION  
U_FINAL_PUNCTUATION  
U_GENERAL_OTHER_TYPES  
U_CHAR_CATEGORY_COUNT  

enum UCharDirection

This specifies the language directional property of a character set.

Enumeration values:
U_LEFT_TO_RIGHT  
U_RIGHT_TO_LEFT  
U_EUROPEAN_NUMBER  
U_EUROPEAN_NUMBER_SEPARATOR  
U_EUROPEAN_NUMBER_TERMINATOR  
U_ARABIC_NUMBER  
U_COMMON_NUMBER_SEPARATOR  
U_BLOCK_SEPARATOR  
U_SEGMENT_SEPARATOR  
U_WHITE_SPACE_NEUTRAL  
U_OTHER_NEUTRAL  
U_LEFT_TO_RIGHT_EMBEDDING  
U_LEFT_TO_RIGHT_OVERRIDE  
U_RIGHT_TO_LEFT_ARABIC  
U_RIGHT_TO_LEFT_EMBEDDING  
U_RIGHT_TO_LEFT_OVERRIDE  
U_POP_DIRECTIONAL_FORMAT  
U_DIR_NON_SPACING_MARK  
U_BOUNDARY_NEUTRAL  
U_CHAR_DIRECTION_COUNT  

enum UCharScript

Generated from Unicode Data files.

Draft:
Enumeration values:
U_BASIC_LATIN  
U_LATIN_1_SUPPLEMENT  
U_LATIN_EXTENDED_A  
U_LATIN_EXTENDED_B  
U_IPA_EXTENSIONS  
U_SPACING_MODIFIER_LETTERS  
U_COMBINING_DIACRITICAL_MARKS  
U_GREEK  
U_CYRILLIC  
U_ARMENIAN  
U_HEBREW  
U_ARABIC  
U_SYRIAC  
U_THAANA  
U_DEVANAGARI  
U_BENGALI  
U_GURMUKHI  
U_GUJARATI  
U_ORIYA  
U_TAMIL  
U_TELUGU  
U_KANNADA  
U_MALAYALAM  
U_SINHALA  
U_THAI  
U_LAO  
U_TIBETAN  
U_MYANMAR  
U_GEORGIAN  
U_HANGUL_JAMO  
U_ETHIOPIC  
U_CHEROKEE  
U_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS  
U_OGHAM  
U_RUNIC  
U_KHMER  
U_MONGOLIAN  
U_LATIN_EXTENDED_ADDITIONAL  
U_GREEK_EXTENDED  
U_GENERAL_PUNCTUATION  
U_SUPERSCRIPTS_AND_SUBSCRIPTS  
U_CURRENCY_SYMBOLS  
U_COMBINING_MARKS_FOR_SYMBOLS  
U_LETTERLIKE_SYMBOLS  
U_NUMBER_FORMS  
U_ARROWS  
U_MATHEMATICAL_OPERATORS  
U_MISCELLANEOUS_TECHNICAL  
U_CONTROL_PICTURES  
U_OPTICAL_CHARACTER_RECOGNITION  
U_ENCLOSED_ALPHANUMERICS  
U_BOX_DRAWING  
U_BLOCK_ELEMENTS  
U_GEOMETRIC_SHAPES  
U_MISCELLANEOUS_SYMBOLS  
U_DINGBATS  
U_BRAILLE_PATTERNS  
U_CJK_RADICALS_SUPPLEMENT  
U_KANGXI_RADICALS  
U_IDEOGRAPHIC_DESCRIPTION_CHARACTERS  
U_CJK_SYMBOLS_AND_PUNCTUATION  
U_HIRAGANA  
U_KATAKANA  
U_BOPOMOFO  
U_HANGUL_COMPATIBILITY_JAMO  
U_KANBUN  
U_BOPOMOFO_EXTENDED  
U_ENCLOSED_CJK_LETTERS_AND_MONTHS  
U_CJK_COMPATIBILITY  
U_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A  
U_CJK_UNIFIED_IDEOGRAPHS  
U_YI_SYLLABLES  
U_YI_RADICALS  
U_HANGUL_SYLLABLES  
U_HIGH_SURROGATES  
U_HIGH_PRIVATE_USE_SURROGATES  
U_LOW_SURROGATES  
U_PRIVATE_USE_AREA  
U_CJK_COMPATIBILITY_IDEOGRAPHS  
U_ALPHABETIC_PRESENTATION_FORMS  
U_ARABIC_PRESENTATION_FORMS_A  
U_COMBINING_HALF_MARKS  
U_CJK_COMPATIBILITY_FORMS  
U_SMALL_FORM_VARIANTS  
U_ARABIC_PRESENTATION_FORMS_B  
U_SPECIALS  
U_HALFWIDTH_AND_FULLWIDTH_FORMS  
U_CHAR_SCRIPT_COUNT  
U_NO_SCRIPT  

enum UCellWidth

Values returned by the u_getCellWidth() function.

Draft:
Enumeration values:
U_ZERO_WIDTH  
U_HALF_WIDTH  
U_FULL_WIDTH  
U_NEUTRAL_WIDTH  
U_CELL_WIDTH_COUNT  

enum UCharNameChoice

Selector constants for u_charName().

u_charName() returns either the "modern" name of a Unicode character or the name that was defined in Unicode version 1.0, before the Unicode standard merged with ISO-10646.

See also:
u_charName()
Enumeration values:
U_UNICODE_CHAR_NAME  
U_UNICODE_10_CHAR_NAME  
U_CHAR_NAME_CHOICE_COUNT  

Function Documentation

U_CAPI bool_t U_EXPORT2 u_islower (UChar c)

Determines whether the specified UChar is a lowercase character according to Unicode 2.1.2.

Parameters:
ch   the character to be tested
Returns:
true if the character is lowercase; false otherwise.
See also:
UNICODE_VERSION , u_isupper() , u_istitle() , u_islower()
Draft:

U_CAPI bool_t U_EXPORT2 u_isupper (UChar c)

Determines whether the specified character is an uppercase character according to Unicode 2.1.2.

Parameters:
ch   the character to be tested
Returns:
true if the character is uppercase; false otherwise.
See also:
u_islower() , u_istitle() , u_tolower()
Draft:

U_CAPI bool_t U_EXPORT2 u_istitle (UChar c)

Determines whether the specified character is a titlecase character according to Unicode 2.1.2.

Parameters:
ch   the character to be tested
Returns:
true if the character is titlecase; false otherwise.
See also:
u_isupper() , u_islower() , u_totitle()
Draft:

U_CAPI bool_t U_EXPORT2 u_isdigit (UChar c)

Determines whether the specified character is a digit according to Unicode 2.1.2.

Parameters:
ch   the character to be tested
Returns:
true if the character is a digit; false otherwise.
Draft:

U_CAPI bool_t U_EXPORT2 u_isalnum (UChar c)

Determines whether the specified character is an alphanumeric character (letter or digit)according to Unicode 2.1.2.

Parameters:
ch   the character to be tested
Returns:
true if the character is a letter or a digit; false otherwise.
Draft:

U_CAPI bool_t U_EXPORT2 u_isdefined (UChar c)

Determines whether the specified numeric value is actually a defined character according to Unicode 2.1.2.

Parameters:
ch   the character to be tested
Returns:
true if the character has a defined Unicode meaning; false otherwise.

See also:
u_isdigit() , u_isalpha() , u_isalnum() , u_isupper() , u_islower() , u_istitle()
Draft:

U_CAPI bool_t U_EXPORT2 u_isalpha (UChar c)

Determines whether the specified character is a letter according to Unicode 2.1.2.

Parameters:
ch   the character to be tested
Returns:
true if the character is a letter; false otherwise.

See also:
u_isdigit() , u_isalnum()
Draft:

U_CAPI bool_t U_EXPORT2 u_isspace (UChar c)

Determines if the specified character is a space character or not.

Parameters:
ch   the character to be tested
Returns:
true if the character is a space character; false otherwise.
Draft:

U_CAPI bool_t U_EXPORT2 u_iscntrl (UChar c)

Determines whether the specified character is a control character or not.

Parameters:
ch   the character to be tested
Returns:
true if the Unicode character is a control character; false otherwise.

See also:
u_isprint()
Draft:

U_CAPI bool_t U_EXPORT2 u_isprint (UChar c)

Determines whether the specified character is a printable character according to Unicode 2.1.2.

Parameters:
ch   the character to be tested
Returns:
true if the Unicode character is a printable character; false otherwise.

See also:
u_iscntrl()
Draft:

U_CAPI bool_t U_EXPORT2 u_isbase (UChar c)

Determines whether the specified character is of the base form according to Unicode 2.1.2.

Parameters:
ch   the character to be tested
Returns:
true if the Unicode character is of the base form; false otherwise.

See also:
u_isalpha() , u_isdigit()
Draft:

U_CAPI UCharDirection U_EXPORT2 u_charDirection (UChar c)

Returns the linguistic direction property of a character.

Returns the linguistic direction property of a character. For example, 0x0041 (letter A) has the LEFT_TO_RIGHT directional property.

See also:
UCharDirection
Draft:

U_CAPI uint16_t U_EXPORT2 u_charCellWidth (UChar c)

Returns a value indicating the display-cell width of the character when used in Asian text, according to the Unicode standard (see p.

6-130 of The Unicode Standard, Version 2.0). The results for various characters are as follows:

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

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

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

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

For Korean text, this algorithm should work properly with properly normalized Korean text. Precomposed Hangul syllables and non-combining jamo are all considered full- width characters. For combining jamo, we treat we treat choseong (initial consonants) as double-width characters and junseong (vowels) and jongseong (final consonants) as non-spacing marks. This will work right in text that uses the precomposed choseong characters instead of teo choseong characters in a row, and which uses the choseong filler character at the beginning of syllables that don't have an initial consonant. The results may be slightly off with Korean text following different conventions.

Draft:

U_CAPI int8_t U_EXPORT2 u_charType (UChar c)

Returns a value indicating a character category according to Unicode 2.1.2.

Parameters:
c   the character to be tested
Returns:
a value of type int, the character category.
See also:
UCharCategory
Draft:

U_CAPI int32_t U_EXPORT2 u_charDigitValue (UChar c)

Retrives the decimal numeric value of a digit character.

Parameters:
c   the digit character for which to get the numeric value
Returns:
the numeric value of ch in decimal radix. This method returns -1 if ch is not a valid digit character.
Draft:

U_CAPI UCharScript U_EXPORT2 u_charScript (UChar ch)

Returns the script associated with a character.

See also:
UCharScript
Draft:

U_CAPI UTextOffset U_EXPORT2 u_charName (uint32_t code, UCharNameChoice nameChoice, char * buffer, UTextOffset bufferLength, UErrorCode * pErrorCode)

Retrieve the name of a Unicode character.

Depending on nameChoice, the character name written into the buffer is the "modern" name or the name that was defined in Unicode version 1.0. The name contains only "invariant" characters like A-Z, 0-9, space, and '-'.

Parameters:
code   The character (code point) for which to get the name. It must be 0<=code<0x10ffff.
nameChoice   Selector for which name to get.
buffer   Destination address for copying the name.
bufferLength   ==sizeof(buffer)
pErrorCode   Pointer to a UErrorCode variable; check for U_SUCCESS() after u_charName() returns.

See also:
UCharNameChoice
Draft:

U_CAPI bool_t U_EXPORT2 u_isIDStart (UChar c)

A convenience method for determining if a Unicode character is allowed to start in a Unicode identifier.

A character may start a Unicode identifier if and only if it is a letter.

Parameters:
c   the Unicode character.
Returns:
TRUE if the character may start a Unicode identifier; FALSE otherwise.
See also:
u_isalpha() , u_isIDPart()
Draft:

U_CAPI bool_t U_EXPORT2 u_isIDPart (UChar c)

A convenience method for determining if a Unicode character may be part of a Unicode identifier other than the starting character.

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

Parameters:
c   the Unicode character.
Returns:
TRUE if the character may be part of a Unicode identifier; FALSE otherwise.
See also:
u_isIDIgnorable() , u_isIDStart()
Draft:

U_CAPI bool_t U_EXPORT2 u_isIDIgnorable (UChar c)

A convenience method for determining if a Unicode character should be regarded as an ignorable character in a Unicode identifier.

The following Unicode characters are ignorable in a Unicode identifier:
0x0000 through 0x0008, ISO control characters that
0x000E through 0x001B, are not whitespace
and 0x007F through 0x009F
0x200C through 0x200F join controls
0x200A through 0x200E bidirectional controls
0x206A through 0x206F format controls
0xFEFF zero-width no-break space

Parameters:
c   the Unicode character.
Returns:
TRUE if the character may be part of a Unicode identifier; FALSE otherwise.
See also:
u_isIDPart()
Draft:

U_CAPI bool_t U_EXPORT2 u_isJavaIDStart (UChar c)

A convenience method for determining if a Unicode character is allowed as the first character in a Java identifier.

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

Parameters:
c   the Unicode character.
Returns:
TRUE if the character may start a Java identifier; FALSE otherwise.
See also:
u_isJavaIDPart() , u_isalpha() , u_isIDStart()
Draft:

U_CAPI bool_t U_EXPORT2 u_isJavaIDPart (UChar c)

A convenience method for determining if a Unicode character may be part of a Java identifier other than the starting character.

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

Parameters:
c   the Unicode character.
Returns:
TRUE if the character may be part of a Unicode identifier; FALSE otherwise.
See also:
u_isIDIgnorable() , u_isJavaIDStart() , u_isalpha() , u_isdigit() , u_isIDPart()
Draft:

U_CAPI UChar U_EXPORT2 u_tolower (UChar c)

The given character is mapped to its lowercase equivalent according to Unicode 2.1.2; if the character has no lowercase equivalent, the character itself is returned.

A character has a lowercase equivalent if and only if a lowercase mapping is specified for the character in the Unicode 2.1.2 attribute table.

u_tolower() only deals with the general letter case conversion. For language specific case conversion behavior, use ustrToUpper(). For example, the case conversion for dot-less i and dotted I in Turkish, or for final sigma in Greek.

Parameters:
ch   the character to be converted
Returns:
the lowercase equivalent of the character, if any; otherwise the character itself.
Draft:

U_CAPI UChar U_EXPORT2 u_toupper (UChar c)

The given character is mapped to its uppercase equivalent according to Unicode 2.1.2; if the character has no uppercase equivalent, the character itself is returned.

u_toupper() only deals with the general letter case conversion. For language specific case conversion behavior, use ustrToUpper(). For example, the case conversion for dot-less i and dotted I in Turkish, or ess-zed (i.e., "sharp S") in German.

Parameters:
ch   the character to be converted
Returns:
the uppercase equivalent of the character, if any; otherwise the character itself.
Draft:

U_CAPI UChar U_EXPORT2 u_totitle (UChar c)

The given character is mapped to its titlecase equivalent according to Unicode 2.1.2.

There are only four Unicode characters that are truly titlecase forms that are distinct from uppercase forms. As a rule, if a character has no true titlecase equivalent, its uppercase equivalent is returned.

A character has a titlecase equivalent if and only if a titlecase mapping is specified for the character in the Unicode 2.1.2 data.

Parameters:
ch   the character to be converted
Returns:
the titlecase equivalent of the character, if any; otherwise the character itself.
Draft:

U_CAPI void U_EXPORT2 u_getUnicodeVersion (UVersionInfo info)

Gets the Unicode version information.

The version array stores the version information for the Unicode standard that is currently used by ICU. For example, release "1.3.31.2" is then represented as 0x01031F02.

Parameters:
versionArray   the version # information, the result will be filled in
Stable:

Variable Documentation

UChar UCHAR_MIN_VALUE [static]

The minimum value a UChar can have.

The lowest value a UChar can have is 0x0000.

UChar UCHAR_MAX_VALUE [static]

The maximum value a UChar can have.

The greatest value a UChar can have is 0xffff.

Draft:

Generated at Thu Feb 10 15:30:13 2000 for icu by doxygen 1.0.0 written by Dimitri van Heesch, © 1997-1999