Main Page   Class Hierarchy   Alphabetical List   Data Structures   File List   Data Fields   Globals  

Unicode Class Reference

This class is deprecated and will be removed. More...

#include <unicode.h>


Public Types

enum  {
  MIN_VALUE = 0, MAX_VALUE = 0x10ffff, MAX_CHAR_LENGTH = UTF_MAX_CHAR_LENGTH, MIN_RADIX = 2,
  MAX_RADIX = 36
}
enum  EUnicodeGeneralTypes {
  UNASSIGNED = 0, UPPERCASE_LETTER = 1, LOWERCASE_LETTER = 2, TITLECASE_LETTER = 3,
  MODIFIER_LETTER = 4, OTHER_LETTER = 5, NON_SPACING_MARK = 6, ENCLOSING_MARK = 7,
  COMBINING_SPACING_MARK = 8, DECIMAL_DIGIT_NUMBER = 9, LETTER_NUMBER = 10, OTHER_NUMBER = 11,
  SPACE_SEPARATOR = 12, LINE_SEPARATOR = 13, PARAGRAPH_SEPARATOR = 14, CONTROL = 15,
  FORMAT = 16, PRIVATE_USE = 17, SURROGATE = 18, DASH_PUNCTUATION = 19,
  START_PUNCTUATION = 20, END_PUNCTUATION = 21, CONNECTOR_PUNCTUATION = 22, OTHER_PUNCTUATION = 23,
  MATH_SYMBOL = 24, CURRENCY_SYMBOL = 25, MODIFIER_SYMBOL = 26, OTHER_SYMBOL = 27,
  INITIAL_PUNCTUATION = 28, FINAL_PUNCTUATION = 29, GENERAL_TYPES_COUNT = 30
}
 Public data for enumerated Unicode general category types. More...

enum  EUnicodeScript {
  kBasicLatin = UBLOCK_BASIC_LATIN, kLatin1Supplement, kLatinExtendedA, kLatinExtendedB,
  kIPAExtension, kSpacingModifier, kCombiningDiacritical, kGreek,
  kCyrillic, kArmenian, kHebrew, kArabic,
  kSyriac, kThaana, kDevanagari, kBengali,
  kGurmukhi, kGujarati, kOriya, kTamil,
  kTelugu, kKannada, kMalayalam, kSinhala,
  kThai, kLao, kTibetan, kMyanmar,
  kGeorgian, kHangulJamo, kEthiopic, kCherokee,
  kUnifiedCanadianAboriginalSyllabics, kogham, kRunic, kKhmer,
  kMongolian, kLatinExtendedAdditional, kGreekExtended, kGeneralPunctuation,
  kSuperSubScript, kCurrencySymbolScript, kSymbolCombiningMark, kLetterlikeSymbol,
  kNumberForm, kArrow, kMathOperator, kMiscTechnical,
  kControlPicture, kOpticalCharacter, kEnclosedAlphanumeric, kBoxDrawing,
  kBlockElement, kGeometricShape, kMiscSymbol, kDingbat,
  kBraillePatterns, kCJKRadicalsSupplement, kKangxiRadicals, kIdeographicDescriptionCharacters,
  kCJKSymbolPunctuation, kHiragana, kKatakana, kBopomofo,
  kHangulCompatibilityJamo, kKanbun, kBopomofoExtended, kEnclosedCJKLetterMonth,
  kCJKCompatibility, kCJKUnifiedIdeographExtensionA, kCJKUnifiedIdeograph, kYiSyllables,
  kYiRadicals, kHangulSyllable, kHighSurrogate, kHighPrivateUseSurrogate,
  kLowSurrogate, kPrivateUse, kCJKCompatibilityIdeograph, kAlphabeticPresentation,
  kArabicPresentationA, kCombiningHalfMark, kCJKCompatibilityForm, kSmallFormVariant,
  kArabicPresentationB, kNoScript, kHalfwidthFullwidthForm, kScriptCount = UBLOCK_COUNT
}
 These are the same values as uchar.h::UCharScript. More...

enum  EDirectionProperty {
  LEFT_TO_RIGHT = 0, RIGHT_TO_LEFT = 1, EUROPEAN_NUMBER = 2, EUROPEAN_NUMBER_SEPARATOR = 3,
  EUROPEAN_NUMBER_TERMINATOR = 4, ARABIC_NUMBER = 5, COMMON_NUMBER_SEPARATOR = 6, BLOCK_SEPARATOR = 7,
  SEGMENT_SEPARATOR = 8, WHITE_SPACE_NEUTRAL = 9, OTHER_NEUTRAL = 10, LEFT_TO_RIGHT_EMBEDDING = 11,
  LEFT_TO_RIGHT_OVERRIDE = 12, RIGHT_TO_LEFT_ARABIC = 13, RIGHT_TO_LEFT_EMBEDDING = 14, RIGHT_TO_LEFT_OVERRIDE = 15,
  POP_DIRECTIONAL_FORMAT = 16, DIR_NON_SPACING_MARK = 17, BOUNDARY_NEUTRAL = 18
}
 This specifies the language directional property of a character set. More...

enum  ECellWidths { ZERO_WIDTH = 0, HALF_WIDTH = 1, FULL_WIDTH = 2, NEUTRAL = 3 }
 Values returned by the getCellWidth() function. More...


Static Public Methods

UBool isSingle (UChar c)
 Does this code unit alone represent a Unicode code point? If so, then the code point value is the same as the code unit value, or (UChar32)c. More...

UBool isLead (UChar c)
 Is this code unit the first of a multiple-unit sequence? Being a single, lead, or trail unit are mutually exclusive properties. More...

UBool isTrail (UChar c)
 Is this code unit one of, but not the first, of a multiple-unit sequence? Being a single, lead, or trail unit are mutually exclusive properties. More...

UBool isSurrogate (UChar32 c)
 Is this code point a surrogate character? Surrogates are not characters; they are reserved for use in UTF-16 strings as leading and trailing code units of multiple-unit sequences for single code points. More...

UBool isUnicodeChar (UChar32 c)
 Is this code point a Unicode character? The value range for Unicode characters is limited to 0x10ffff==MAX_VALUE, and some values within this range are reserved and not characters, too. More...

UBool isError (UChar32 c)
 Is this code point an error value? In ICU, code point access with macros or functions does not result in a UErrorCode to be set if a code unit sequence is illegal or irregular, but instead the resulting code point will be one of few special error values. More...

UBool isValid (UChar32 c)
 Is this code point a Unicode character, and not an error value? This is an efficient combination of isUnicodeChar(c) && !isError(c). More...

UBool needMultipleUChar (UChar32 c)
 When writing code units for a given code point, is more than one code unit necessary? If not, then a single UChar value of (UChar)c can be written to a UChar array. More...

int32_t charLength (UChar32 c)
 When writing code units for a given code point, how many code units are necessary? More...

int32_t arraySize (int32_t size)
 This function returns an average size of a UChar array compared to the size that it would need to hold similar text if UTF-16 were used. More...

UBool isLowerCase (UChar32 ch)
 Determines whether the specified UChar is a lowercase character according to Unicode 2.1.2. More...

UBool isUpperCase (UChar32 ch)
 Determines whether the specified character is an uppercase character according to Unicode 2.1.2. More...

UBool isTitleCase (UChar32 ch)
 Determines whether the specified character is a titlecase character according to Unicode 2.1.2. More...

UBool isDigit (UChar32 ch)
 Determines whether the specified character is a digit according to Unicode 2.1.2. More...

UBool isDefined (UChar32 ch)
 Determines whether the specified numeric value is actually a defined character according to Unicode 2.1.2. More...

UBool isControl (UChar32 ch)
 Determines whether the specified character is a control character according to Unicode 2.1.2. More...

UBool isPrintable (UChar32 ch)
 Determines whether the specified character is a printable character according to Unicode 2.1.2. More...

UBool isBaseForm (UChar32 ch)
 Determines whether the specified character is of the base form according to Unicode 2.1.2. More...

UBool isLetter (UChar32 ch)
 Determines whether the specified character is a letter according to Unicode 2.1.2. More...

UBool isJavaIdentifierStart (UChar32 ch)
 A convenience method for determining if a Unicode character is allowed as the first character in a Java identifier. More...

UBool isJavaIdentifierPart (UChar32 ch)
 A convenience method for determining if a Unicode character may be part of a Java identifier other than the starting character. More...

UBool isUnicodeIdentifierStart (UChar32 ch)
 A convenience method for determining if a Unicode character is allowed to start in a Unicode identifier. More...

UBool isUnicodeIdentifierPart (UChar32 ch)
 A convenience method for determining if a Unicode character may be part of a Unicode identifier other than the starting character. More...

UBool isIdentifierIgnorable (UChar32 ch)
 A convenience method for determining if a Unicode character should be regarded as an ignorable character in a Java identifier or a Unicode identifier. More...

UChar32 toLowerCase (UChar32 ch)
 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...

UChar32 toUpperCase (UChar32 ch)
 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...

UChar32 toTitleCase (UChar32 ch)
 The given character is mapped to its titlecase equivalent according to Unicode 2.1.2. More...

UChar32 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. More...

UBool isSpaceChar (UChar32 ch)
 Determines if the specified character is a Unicode space character according to Unicode 2.1.2. More...

UBool isWhitespace (UChar32 ch)
 Determines if the specified character is white space according to ICU. More...

int8_t getType (UChar32 ch)
 Returns a value indicating a character category according to Unicode 2.1.2. More...

uint8_t getCombiningClass (UChar32 c)
 Returns the combining class of the code point as specified in UnicodeData.txt. More...

EDirectionProperty characterDirection (UChar32 ch)
 Returns the linguistic direction property of a character. More...

UBool isMirrored (UChar32 c)
 Determines whether the character has the "mirrored" property. More...

UChar32 charMirror (UChar32 c)
 Maps the specified character to a "mirror-image" character. More...

EUnicodeScript getScript (UChar32 ch)
 Returns the script associated with a character. More...

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

UTextOffset getCharName (uint32_t code, char *buffer, UTextOffset bufferLength, UCharNameChoice nameChoice=U_UNICODE_CHAR_NAME)
 Retrieve the name of a Unicode character. More...

int32_t digitValue (UChar32 ch)
 Retrives the decimal numeric value of a digit character. More...

int32_t digit (UChar32 ch, int8_t radix)
 Returns the numeric value of the character ch in the specified radix. More...

UChar32 forDigit (int32_t digit, int8_t radix)
 Determines the character representation for a specific digit in the specified radix. More...

void getUnicodeVersion (UVersionInfo info)
 Retrieves the Unicode Standard Version number that is used. More...


Protected Methods

 Unicode ()
 Unicode (const Unicode &other)
 ~Unicode ()
const Unicode & operator= (const Unicode &other)


Detailed Description

This class is deprecated and will be removed.

Use the C API, see uchar.h and utf.h. The Unicode class is a pure 1:1 wrapper for the functions and macros there.

Old documentation:

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

The Unicode character information, provided implicitly by the Unicode Standard, includes information about the sript (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.

@subclassing Do not subclass.

Deprecated:
To be removed after 2002-sep-30; use the C API, see uchar.h and utf.h.


Member Enumeration Documentation

anonymous enum
 

Enumeration values:
MIN_VALUE  The lowest Unicode code point value.

Code points are non-negative.

MAX_VALUE  The highest Unicode code point value (scalar value) according to The Unicode Standard.

This is a 21-bit value (20.1 bits, rounded up). For a single character, UChar32 is a simple type that can hold any code point value.

MAX_CHAR_LENGTH  The maximum number of code units (UChar's) per code point (UChar32).

This depends on the default UTF that the ICU library is compiled for. Currently, the only natively supported UTF is UTF-16, which means that UChar is 16 bits wide and this value is 2 (for surrogate pairs). This may change in the future.

MIN_RADIX  The minimum radix available for conversion to and from Strings.

The constant value of this field is the smallest value permitted for the radix argument in radix-conversion methods such as the digit method and the forDigit method.

See also:
Unicode::digit , Unicode::forDigit
MAX_RADIX  The maximum radix available for conversion to and from Strings.

The constant value of this field is the largest value permitted for the radix argument in radix-conversion methods such as the digit method and the forDigit method.

See also:
Unicode::digit , Unicode::forDigit

enum Unicode::ECellWidths
 

Values returned by the getCellWidth() function.

See also:
Unicode::getCellWidth
Deprecated:
See the Unicode class description.

enum Unicode::EDirectionProperty
 

This specifies the language directional property of a character set.

Deprecated:
See the Unicode class description.

enum Unicode::EUnicodeGeneralTypes
 

Public data for enumerated Unicode general category types.

Deprecated:
See the Unicode class description.

enum Unicode::EUnicodeScript
 

These are the same values as uchar.h::UCharScript.

Deprecated:
See the Unicode class description.


Member Function Documentation

int32_t Unicode::arraySize int32_t    size [inline, static]
 

This function returns an average size of a UChar array compared to the size that it would need to hold similar text if UTF-16 were used.

With UTF-16, this always returns its argument. With UTF-8, the number returned will be larger, with UTF-32, smaller. It will typically be less than size*MAX_CHAR_LENGTH.

Parameters:
size  The size of the array if UTF-16 were used.
Returns:
An average size necessary for the UTF that ICU was compiled for. (Only UTF-16 is supported right now, therefore, this will always be size itself. This may change in the future.)
Deprecated:
See the Unicode class description.

Unicode::EDirectionProperty Unicode::characterDirection UChar32    ch [inline, static]
 

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:
EDirectionProperty
Deprecated:
See the Unicode class description.

int32_t Unicode::charLength UChar32    c [inline, static]
 

When writing code units for a given code point, how many code units are necessary?

Parameters:
c  The code point to be tested.
Returns:
Boolean value.
Deprecated:
See the Unicode class description.

UChar32 Unicode::charMirror UChar32    c [inline, static]
 

Maps the specified character to a "mirror-image" character.

For characters with the "mirrored" property, implementations sometimes need a "poor man's" mapping to another Unicode character (code point) such that the default glyph may serve as the mirror-image of the default glyph of the specified character. This is useful for text conversion to and from codepages with visual order, and for displays without glyph selecetion capabilities.

Parameters:
c  the character (code point, Unicode scalar value) to be mapped
Returns:
another Unicode code point that may serve as a mirror-image substitute, or c itself if there is no such mapping or c does not have the "mirrored" property
Deprecated:
See the Unicode class description.

int32_t Unicode::digit UChar32    ch,
int8_t    radix
[inline, static]
 

Returns the numeric value of the character ch in the specified radix.

If the radix is not in the range MIN_RADIX <= radix <= MAX_RADIX or if the value of ch 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:

  • The method isDigit is true of the character and the Unicode decimal digit value of the character (or its single-character decomposition) is less than the specified radix. In this case the decimal digit value is returned.
  • The character is one of the uppercase Latin letters 'A' through 'Z' and its code is less than radix + 'A' - 10. In this case, ch - 'A' + 10 is returned.
  • The character is one of the lowercase Latin letters 'a' through 'z' and its code is less than radix + 'a' - 10. In this case, ch - 'a' + 10 is returned.
Parameters:
ch  the character to be converted.
radix  the radix.
Returns:
the numeric value represented by the character in the specified radix.
See also:
Unicode::MIN_RADIX , Unicode::MAX_RADIX , Unicode::forDigit , Unicode::digitValue , Unicode::isDigit
Deprecated:
See the Unicode class description.

int32_t Unicode::digitValue UChar32    ch [inline, static]
 

Retrives the decimal numeric value of a digit character.

Parameters:
ch  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.
See also:
Unicode::digit , Unicode::forDigit , Unicode::isDigit
Deprecated:
See the Unicode class description.

UChar32 Unicode::foldCase UChar32    c,
uint32_t    options
[inline, static]
 

The given character is mapped to its case folding equivalent according to UnicodeData.txt and CaseFolding.txt; if the character has no case folding equivalent, the character itself is returned.

Only "simple", single-code point case folding mappings are used. "Full" mappings are used by UnicodeString::foldCase().

Parameters:
c  the character to be converted
options  Either U_FOLD_CASE_DEFAULT or U_FOLD_CASE_EXCLUDE_SPECIAL_I
Returns:
the case folding equivalent of the character, if any; otherwise the character itself.
Deprecated:
See the Unicode class description.

UChar32 Unicode::forDigit int32_t    digit,
int8_t    radix
[inline, static]
 

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 MIN_RADIX and less than or equal to MAX_RADIX. 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.

Parameters:
digit  the number to convert to a character.
radix  the radix.
Returns:
the char representation of the specified digit in the specified radix.
See also:
Unicode::MIN_RADIX , Unicode::MAX_RADIX , Unicode::digit , Unicode::digitValue , Unicode::isDigit
Deprecated:
See the Unicode class description.

uint16_t Unicode::getCellWidth UChar32    ch [inline, static]
 

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.

Deprecated:
See the Unicode class description.

UTextOffset Unicode::getCharName uint32_t    code,
char *    buffer,
UTextOffset    bufferLength,
UCharNameChoice    nameChoice = U_UNICODE_CHAR_NAME
[inline, static]
 

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.
buffer  Destination address for copying the name.
bufferLength  ==sizeof(buffer)
nameChoice  Selector for which name to get.
See also:
UCharNameChoice
Example:
 &#32;   char buffer[100];
 &#32;   UTextOffset length=Unicode::getCharName(
 &#32;           0x284, buffer, sizeof(buffer));
 &#32; 
 &#32;   // use invariant-character conversion to Unicode
 &#32;   UnicodeString name(buffer, length, "");
 

Deprecated:
See the Unicode class description.

uint8_t Unicode::getCombiningClass UChar32    c [inline, static]
 

Returns the combining class of the code point as specified in UnicodeData.txt.

Parameters:
c  the code point of the character
Returns:
the combining class of the character
Deprecated:
See the Unicode class description.

Unicode::EUnicodeScript Unicode::getScript UChar32    ch [inline, static]
 

Returns the script associated with a character.

See also:
EUnicodeScript @draft

int8_t Unicode::getType UChar32    ch [inline, static]
 

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

Parameters:
ch  the character to be tested
Returns:
a value of type int, the character category.
See also:
Unicode::UNASSIGNED , Unicode::UPPERCASE_LETTER , Unicode::LOWERCASE_LETTER , Unicode::TITLECASE_LETTER , Unicode::MODIFIER_LETTER , Unicode::OTHER_LETTER , Unicode::NON_SPACING_MARK , Unicode::ENCLOSING_MARK , Unicode::COMBINING_SPACING_MARK , Unicode::DECIMAL_DIGIT_NUMBER , Unicode::OTHER_NUMBER , Unicode::SPACE_SEPARATOR , Unicode::LINE_SEPARATOR , Unicode::PARAGRAPH_SEPARATOR , Unicode::CONTROL , Unicode::PRIVATE_USE , Unicode::SURROGATE , Unicode::DASH_PUNCTUATION , Unicode::OPEN_PUNCTUATION , Unicode::CLOSE_PUNCTUATION , Unicode::CONNECTOR_PUNCTUATION , Unicode::OTHER_PUNCTUATION , Unicode::LETTER_NUMBER , Unicode::MATH_SYMBOL , Unicode::CURRENCY_SYMBOL , Unicode::MODIFIER_SYMBOL , Unicode::OTHER_SYMBOL
Deprecated:
See the Unicode class description.

void Unicode::getUnicodeVersion UVersionInfo    info [inline, static]
 

Retrieves the Unicode Standard Version number that is used.

Parameters:
info  the version # information, the result will be filled in
Deprecated:
See the Unicode class description.

UBool Unicode::isBaseForm UChar32    ch [inline, static]
 

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:
Unicode::isLetter , Unicode::isDigit
Deprecated:
See the Unicode class description.

UBool Unicode::isControl UChar32    ch [inline, static]
 

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

Parameters:
ch  the character to be tested
Returns:
true if the Unicode character is a control character; false otherwise.
See also:
Unicode::isPrintable
Deprecated:
See the Unicode class description.

UBool Unicode::isDefined UChar32    ch [inline, static]
 

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:
Unicode::isDigit , Unicode::isLetter , Unicode::isLetterOrDigit , Unicode::isUpperCase , Unicode::isLowerCase , Unicode::isTitleCase
Deprecated:
See the Unicode class description.

UBool Unicode::isDigit UChar32    ch [inline, static]
 

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.
See also:
Unicode::digit , Unicode::forDigit , Unicode::digitValue
Deprecated:
See the Unicode class description.

UBool Unicode::isError UChar32    c [inline, static]
 

Is this code point an error value? In ICU, code point access with macros or functions does not result in a UErrorCode to be set if a code unit sequence is illegal or irregular, but instead the resulting code point will be one of few special error values.

This function tests for one of those.

Parameters:
c  The code point to be tested.
Returns:
Boolean value.
Deprecated:
See the Unicode class description.

UBool Unicode::isIdentifierIgnorable UChar32    ch [inline, static]
 

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

The following Unicode characters are ignorable in a Java identifier or 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:
ch  the Unicode character.
Returns:
TRUE if the character may be part of a Unicode identifier; FALSE otherwise.
See also:
isJavaIdentifierPart , isUnicodeIdentifierPart
Deprecated:
See the Unicode class description.

UBool Unicode::isJavaIdentifierPart UChar32    ch [inline, static]
 

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:

  • a letter
  • a currency symbol (such as "$")
  • a connecting punctuation character (such as "_").
  • a digit
  • a numeric letter (such as a Roman numeral character)
  • a combining mark
  • a non-spacing mark
  • an ignorable control character
Parameters:
ch  the Unicode character.
Returns:
TRUE if the character may be part of a Unicode identifier; FALSE otherwise.
See also:
isIdentifierIgnorable , isJavaIdentifierStart , isLetter , isDigit , isUnicodeIdentifierPart
Deprecated:
See the Unicode class description.

UBool Unicode::isJavaIdentifierStart UChar32    ch [inline, static]
 

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:

  • a letter
  • a currency symbol (such as "$")
  • a connecting punctuation symbol (such as "_").
Parameters:
ch  the Unicode character.
Returns:
TRUE if the character may start a Java identifier; FALSE otherwise.
See also:
isJavaIdentifierPart , isLetter , isUnicodeIdentifierStart
Deprecated:
See the Unicode class description.

UBool Unicode::isLead UChar    c [inline, static]
 

Is this code unit the first of a multiple-unit sequence? Being a single, lead, or trail unit are mutually exclusive properties.

Parameters:
c  The code unit to be tested.
Returns:
Boolean value.
Deprecated:
See the Unicode class description.

UBool Unicode::isLetter UChar32    ch [inline, static]
 

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:
Unicode::isDigit , Unicode::isLetterOrDigit , Unicode::isUpperCase , Unicode::isLowerCase , Unicode::isTitleCase
Deprecated:
See the Unicode class description.

UBool Unicode::isLowerCase UChar32    ch [inline, static]
 

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::isUpperCase , Unicode::isTitleCase , Unicode::toLowerCase
Deprecated:
See the Unicode class description.

UBool Unicode::isMirrored UChar32    c [inline, static]
 

Determines whether the character has the "mirrored" property.

This property is set for characters that are commonly used in Right-To-Left contexts and need to be displayed with a "mirrored" glyph.

Parameters:
c  the character (code point, Unicode scalar value) to be tested
Returns:
TRUE if the character has the "mirrored" property
Deprecated:
See the Unicode class description.

UBool Unicode::isPrintable UChar32    ch [inline, static]
 

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:
Unicode::isControl
Deprecated:
See the Unicode class description.

UBool Unicode::isSingle UChar    c [inline, static]
 

Does this code unit alone represent a Unicode code point? If so, then the code point value is the same as the code unit value, or (UChar32)c.

Being a single, lead, or trail unit are mutually exclusive properties.

Parameters:
c  The code unit to be tested.
Returns:
Boolean value.
Deprecated:
See the Unicode class description.

UBool Unicode::isSpaceChar UChar32    ch [inline, static]
 

Determines if the specified character is a Unicode space character according to Unicode 2.1.2.

Parameters:
ch  the character to be tested
Returns:
true if the character is a space character; false otherwise.
Deprecated:
See the Unicode class description.

UBool Unicode::isSurrogate UChar32    c [inline, static]
 

Is this code point a surrogate character? Surrogates are not characters; they are reserved for use in UTF-16 strings as leading and trailing code units of multiple-unit sequences for single code points.

Parameters:
c  The code point to be tested.
Returns:
Boolean value.
Deprecated:
See the Unicode class description.

UBool Unicode::isTitleCase UChar32    ch [inline, static]
 

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:
Unicode::isUpperCase , Unicode::isLowerCase , Unicode::toTitleCase
Deprecated:
See the Unicode class description.

UBool Unicode::isTrail UChar    c [inline, static]
 

Is this code unit one of, but not the first, of a multiple-unit sequence? Being a single, lead, or trail unit are mutually exclusive properties.

Parameters:
c  The code unit to be tested.
Returns:
Boolean value.
Deprecated:
See the Unicode class description.

UBool Unicode::isUnicodeChar UChar32    c [inline, static]
 

Is this code point a Unicode character? The value range for Unicode characters is limited to 0x10ffff==MAX_VALUE, and some values within this range are reserved and not characters, too.

Those are the surrogate values and all values where the least significant 16 bits are either 0xfffe or 0xffff.

Parameters:
c  The code point to be tested.
Returns:
Boolean value.
Deprecated:
See the Unicode class description.

UBool Unicode::isUnicodeIdentifierPart UChar32    ch [inline, static]
 

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:

  • a letter
  • a connecting punctuation character (such as "_").
  • a digit
  • a numeric letter (such as a Roman numeral character)
  • a combining mark
  • a non-spacing mark
  • an ignorable control character
Parameters:
ch  the Unicode character.
Returns:
TRUE if the character may be part of a Unicode identifier; FALSE otherwise.
See also:
isIdentifierIgnorable , isJavaIdentifierPart , isLetterOrDigit , isUnicodeIdentifierStart
Deprecated:
See the Unicode class description.

UBool Unicode::isUnicodeIdentifierStart UChar32    ch [inline, static]
 

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:
ch  the Unicode character.
Returns:
TRUE if the character may start a Unicode identifier; FALSE otherwise.
See also:
isJavaIdentifierStart , isLetter , isUnicodeIdentifierPart
Deprecated:
See the Unicode class description.

UBool Unicode::isUpperCase UChar32    ch [inline, static]
 

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:
Unicode::isLowerCase , Unicode::isTitleCase , Unicode::toUpperCase
Deprecated:
See the Unicode class description.

UBool Unicode::isValid UChar32    c [inline, static]
 

Is this code point a Unicode character, and not an error value? This is an efficient combination of isUnicodeChar(c) && !isError(c).

Parameters:
c  The code point to be tested.
Returns:
Boolean value.
Deprecated:
See the Unicode class description.

UBool Unicode::isWhitespace UChar32    ch [inline, static]
 

Determines if the specified character is white space according to ICU.

A character is considered to be an ICU whitespace character if and only if it satisfies one of the following criteria:

  • It is a Unicode space separator (category "Zs"), but is not a no-break space (&#92;u00A0 or &#92;uFEFF).
  • It is a Unicode line separator (category "Zl").
  • It is a Unicode paragraph separator (category "Zp").
  • It is &#92;u0009, HORIZONTAL TABULATION.
  • It is &#92;u000A, LINE FEED.
  • It is &#92;u000B, VERTICAL TABULATION.
  • It is &#92;u000C, FORM FEED.
  • It is &#92;u000D, CARRIAGE RETURN.
  • It is &#92;u001C, FILE SEPARATOR.
  • It is &#92;u001D, GROUP SEPARATOR.
  • It is &#92;u001E, RECORD SEPARATOR.
  • It is &#92;u001F, UNIT SEPARATOR.
Note: This method corresponds to the Java method java.lang.Character.isWhitespace().
Parameters:
ch  the character to be tested.
Returns:
true if the character is an ICU whitespace character; false otherwise.
See also:
isSpaceChar
Deprecated:
See the Unicode class description.

UBool Unicode::needMultipleUChar UChar32    c [inline, static]
 

When writing code units for a given code point, is more than one code unit necessary? If not, then a single UChar value of (UChar)c can be written to a UChar array.

Otherwise, multiple code units need to be calculated and written.

Parameters:
c  The code point to be tested.
Returns:
Boolean value.
Deprecated:
See the Unicode class description.

UChar32 Unicode::toLowerCase UChar32    ch [inline, static]
 

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.0 attribute table.

Unicode::toLowerCase() only deals with the general letter case conversion. For language specific case conversion behavior, use UnicodeString::toLower(). 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.
See also:
UnicodeString::toLower , Unicode::isLowerCase , Unicode::isUpperCase , Unicode::toUpperCase , Unicode::toTitleCase
Deprecated:
See the Unicode class description.

UChar32 Unicode::toTitleCase UChar32    ch [inline, static]
 

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.
See also:
Unicode::isTitleCase , Unicode::toUpperCase , Unicode::toLowerCase
Deprecated:
See the Unicode class description.

UChar32 Unicode::toUpperCase UChar32    ch [inline, static]
 

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.

Unicode::toUpperCase() only deals with the general letter case conversion. For language specific case conversion behavior, use UnicodeString::toUpper(). 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.
See also:
UnicodeString::toUpper , Unicode::isUpperCase , Unicode::isLowerCase , Unicode::toLowerCase , Unicode::toTitleCase
Deprecated:
See the Unicode class description.


The documentation for this class was generated from the following file:
Generated on Mon Mar 4 20:10:47 2002 for ICU 2.0 by doxygen1.2.14 written by Dimitri van Heesch, © 1997-2002