Main Page | Class Hierarchy | Alphabetical List | Data Structures | Directories | File List | Data Fields | Globals | Related Pages

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 Member Functions

static 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.
static 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.
static 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.
static 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.
static 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.
static 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.
static 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).
static 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.
static int32_t charLength (UChar32 c)
 When writing code units for a given code point, how many code units are necessary?
static 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.
static UBool isLowerCase (UChar32 ch)
 Determines whether the specified UChar is a lowercase character according to Unicode 2.1.2.
static UBool isUpperCase (UChar32 ch)
 Determines whether the specified character is an uppercase character according to Unicode 2.1.2.
static UBool isTitleCase (UChar32 ch)
 Determines whether the specified character is a titlecase character according to Unicode 2.1.2.
static UBool isDigit (UChar32 ch)
 Determines whether the specified character is a digit according to Unicode 2.1.2.
static UBool isDefined (UChar32 ch)
 Determines whether the specified numeric value is actually a defined character according to Unicode 2.1.2.
static UBool isControl (UChar32 ch)
 Determines whether the specified character is a control character according to Unicode 2.1.2.
static UBool isPrintable (UChar32 ch)
 Determines whether the specified character is a printable character according to Unicode 2.1.2.
static UBool isBaseForm (UChar32 ch)
 Determines whether the specified character is of the base form according to Unicode 2.1.2.
static UBool isLetter (UChar32 ch)
 Determines whether the specified character is a letter according to Unicode 2.1.2.
static UBool isJavaIdentifierStart (UChar32 ch)
 A convenience method for determining if a Unicode character is allowed as the first character in a Java identifier.
static 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.
static UBool isUnicodeIdentifierStart (UChar32 ch)
 A convenience method for determining if a Unicode character is allowed to start in a Unicode identifier.
static 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.
static 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.
static 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.
static 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.
static UChar32 toTitleCase (UChar32 ch)
 The given character is mapped to its titlecase equivalent according to Unicode 2.1.2.
static 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.
static UBool isSpaceChar (UChar32 ch)
 Determines if the specified character is a Unicode space character according to Unicode 2.1.2.
static UBool isWhitespace (UChar32 ch)
 Determines if the specified character is white space according to ICU.
static int8_t getType (UChar32 ch)
 Returns a value indicating a character category according to Unicode 2.1.2.
static uint8_t getCombiningClass (UChar32 c)
 Returns the combining class of the code point as specified in UnicodeData.txt.
static EDirectionProperty characterDirection (UChar32 ch)
 Returns the linguistic direction property of a character.
static UBool isMirrored (UChar32 c)
 Determines whether the character has the "mirrored" property.
static UChar32 charMirror (UChar32 c)
 Maps the specified character to a "mirror-image" character.
static EUnicodeScript getScript (UChar32 ch)
 Returns the script associated with a character.
static 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.
static int32_t getCharName (uint32_t code, char *buffer, int32_t bufferLength, UCharNameChoice nameChoice=U_UNICODE_CHAR_NAME)
 Retrieve the name of a Unicode character.
static int32_t digitValue (UChar32 ch)
 Retrives the decimal numeric value of a digit character.
static int32_t digit (UChar32 ch, int8_t radix)
 Returns the numeric value of the character ch in the specified radix.
static UChar32 forDigit (int32_t digit, int8_t radix)
 Determines the character representation for a specific digit in the specified radix.
static void getUnicodeVersion (UVersionInfo info)
 Retrieves the Unicode Standard Version number that is used.

Protected Member Functions

 Unicode (const Unicode &other)
const Unicodeoperator= (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.

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.

int32_t Unicode::getCharName uint32_t  code,
char *  buffer,
int32_t  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;   int32_t 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

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 May 23 00:59:25 2005 for ICU 2.1 by  doxygen 1.4.2