RWUCharTraits
Module: Internationalization Module Group: Unicode String Processing
Does Not Inherit
Local Index
Members
Header File
#include <rw/i18n/RWUCharTraits.h>
Description
RWUCharTraits provides methods for querying the properties of Unicode characters.
The Unicode Standard defines a comprehensive set of properties for each code point in the Unicode character set. The set of properties and the values of those properties are specified by the Unicode Character Database:
http://www.unicode.org/unicode/onlinedat/online.html
that is published as part of the Unicode Standard:
http://www.unicode.org/unicode/standard/standard.html
Unicode character properties may be either normative or informative, as defined in Chapter 3, "Conformance", of the Unicode Standard:
Normative properties are required for conformance with the Unicode Standard. Implementations that claim conformance to the Unicode Standard and that make use of a particular normative property must follow the specifications of the standard for that property to be conformant.
Informative properties are strongly recommended, but a conformant implementation is free to use or change such values as it may require, while still remaining conformant to the standard.
RWUCharTraits provides access to both normative and informative properties of Unicode characters.
Public Enums
enum GeneralCategory {
BeginGeneralCategory,
Unassigned = BeginGeneralCategory,
UppercaseLetter, // Lu (Normative)
LowercaseLetter, // Ll (Normative)
TitlecaseLetter, // Lt (Normative)
ModifierLetter, // Lm (Informative)
OtherLetter, // Lo (Informative)
NonSpacingMark, // Mn (Normative)
EnclosingMark, // Me (Normative)
CombiningSpacingMark, // Mc (Normative)
DecimalDigitNumber, // Nd (Normative)
LetterNumber, // Nl (Normative)
OtherNumber, // No (Normative)
SpaceSeparator, // Zs (Normative)
LineSeparator, // Zl (Normative)
ParagraphSeparator, // Zp (Normative)
ControlChar, // Cc (Normative)
FormatChar, // Cf (Normative)
PrivateUseChar, // Co (Normative)
Surrogate, // Cs (Normative)
DashPunctuation, // Pd (Informative)
StartPunctuation, // Ps (Informative)
EndPunctuation, // Pe (Informative)
ConnectorPunctuation, // Pc (Informative)
OtherPunctuation, // Po (Informative)
MathSymbol, // Sm (Informative)
CurrencySymbol, // Sc (Informative)
ModifierSymbol, // Sk (Informative)
OtherSymbol, // So (Informative)
InitialPunctuation, // Pi (Informative)
FinalPunctuation, // Pf (Informative)
GeneralOtherTypes, // Cn (Normative)
EndGeneralCategory
};
An enumeration of the general categories used to classify Unicode characters. The values in this enumeration correspond to the general category property codes that appear in the UnicodeData.txt file of the Unicode Character Database, as described in:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
See also the getGeneralCategory() method.
enum BidirectionalCategory {
NoBidirectionalCategory,
BeginBidirectionalCategory,
LeftToRight =
BeginBidirectionalCategory,
// L
RightToLeft, // R
EuropeanNumber, // EN
EuropeanNumberSeparator, // ES
EuropeanNumberTerminator, // ET
ArabicNumber, // AN
CommonNumberSeparator, // CS
BlockSeparator, // B
SegmentSeparator, // S
WhiteSpaceNeutral, // WS
OtherNeutral, // ON
LeftToRightEmbedding, // LRE
LeftToRightOverride, // LRO
RightToLeftArabic, // AL
RightToLeftEmbedding, // RLE
RightToLeftOverride, // RLO
PopDirectionalFormat, // PDF
DirNonSpacingMark, // NSM
BoundaryNeutral, // BN
EndBidirectionalCategory
};
An enumeration used to describe the linguistic direction of a Unicode character code point. The values in this enumeration correspond to the bidirectional category property codes that appear in the file UnicodeData.txt of the Unicode Character Database, as described in
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
The bidirectional property is a normative property of the Unicode Standard. See also the getBidirectionalCategory() method.
enum Block {
BeginBlock,
BasicLatinBlock = BeginBlock,
Latin1SupplementBlock,
LatinExtendedABlock,
LatinExtendedBBlock,
IpaExtensionsBlock,
SpacingModifierLettersBlock,
CombiningDiacriticalMarksBlock,
GreekAndCopticBlock,
CyrillicBlock,
ArmenianBlock,
HebrewBlock,
ArabicBlock,
SyriacBlock,
ThaanaBlock,
DevanagariBlock,
BengaliBlock,
GurmukhiBlock,
GujaratiBlock,
OriyaBlock,
TamilBlock,
TeluguBlock,
KannadaBlock,
MalayalamBlock,
SinhalaBlock,
ThaiBlock,
LaoBlock,
TibetanBlock,
MyanmarBlock,
GeorgianBlock,
HangulJamoBlock,
EthiopicBlock,
CherokeeBlock,
UnifiedCanadianAboriginalSyllabicsBlock,
OghamBlock,
RunicBlock,
TagalogBlock,
HanunooBlock,
BuhidBlock,
TagbanwaBlock,
KhmerBlock,
MongolianBlock,
LatinExtendedAdditionalBlock,
GreekExtendedBlock,
GeneralPunctuationBlock,
SuperscriptsAndSubscriptsBlock,
CurrencySymbolsBlock,
CombiningDiacriticalMarksForSymbolsBlock,
LetterlikeSymbolsBlock,
NumberFormsBlock,
ArrowsBlock,
MathematicalOperatorsBlock,
MiscellaneousTechnicalBlock,
ControlPicturesBlock,
OpticalCharacterRecognitionBlock,
EnclosedAlphanumericsBlock,
BoxDrawingBlock,
BlockElementsBlock,
GeometricShapesBlock,
MiscellaneousSymbolsBlock,
DingbatsBlock,
MiscellaneousMathematicalSymbolsABlock,
SupplementalArrowsABlock,
BraillePatternsBlock,
SupplementalArrowsBBlock,
MiscellaneousMathematicalSymbolsBBlock,
SupplementalMathematicalOperatorsBlock,
CjkRadicalsSupplementBlock,
KangxiRadicalsBlock,
IdeographicDescriptionCharactersBlock,
CjkSymbolsAndPunctuationBlock,
HiraganaBlock,
KatakanaBlock,
BopomofoBlock,
HangulCompatibilityJamoBlock,
KanbunBlock,
BopomofoExtendedBlock,
KatakanaPhoneticExtensionsBlock,
EnclosedCjkLettersAndMonthsBlock,
CjkCompatibilityBlock,
CjkUnifiedIdeographsExtensionABlock,
CjkUnifiedIdeographsBlock,
YiSyllablesBlock,
YiRadicalsBlock,
HangulSyllablesBlock,
HighSurrogatesBlock,
HighPrivateUseSurrogatesBlock,
LowSurrogatesBlock,
PrivateUseAreaBlock,
CjkCompatibilityIdeographsBlock,
AlphabeticPresentationFormsBlock,
ArabicPresentationFormsABlock,
CombiningHalfMarksBlock,
CjkCompatibilityFormsBlock,
SmallFormVariantsBlock,
ArabicPresentationFormsBBlock,
VariationSelectorsBlock,
HalfwidthAndFullwidthFormsBlock,
SpecialsBlock,
OldItalicBlock,
GothicBlock,
DeseretBlock,
ByzantineMusicalSymbolsBlock,
MusicalSymbolsBlock,
MathematicalAlphanumericSymbolsBlock,
CjkUnifiedIdeographsExtensionBBlock,
CjkCompatibilityIdeographsSupplementBlock,
TagsBlock,
PrivateUseBlock,
SupplementaryPrivateUseAreaABlock,
SupplementaryPrivateUseAreaBBlock,
NoBlock,
InvalidBlock,
EndBlock = NoBlock
};
An enumeration used to identify the various Unicode character blocks. The values in this enumeration correspond to the block names that appear in the file Blocks.txt of the Unicode Character Database, as described in Chapter 14, "Code Charts", of the Unicode Standard:
http://www.unicode.org/unicode/standard/standard.html
The block property is an informative property of the Unicode Standard. See also the getBlock() and getScript() methods.
enum Script { BeginScript,
Latin = BeginScript,
Greek,
Cyrillic,
Armenian,
Hebrew,
Arabic,
Syriac,
Thaana,
Devanagari,
Bengali,
Gurmukhi,
Gujarati,
Oriya,
Tamil,
Telugu,
Kannada,
Malayalam,
Sinhala,
Thai,
Lao,
Tibetan,
Myanmar,
Georgian,
Hangul,
Ethiopic,
Cherokee,
CanadianAboriginal,
Ogham,
Runic,
Khmer,
Mongolian,
Hiragana,
Katakana,
Bopomofo,
Han,
Yi,
OldItalic,
Gothic,
Deseret,
Inherited,
NoScript,
InvalidScript = NoScript,
EndScript = NoScript
};
An enumeration used to identify Unicode scripts. The values in this enumeration correspond to the script property names defined in the Scripts.txt file of the Unicode Character Database, as described in Unicode Technical Report #24, "Script Names":
http://www.unicode.org/unicode/reports/tr24
The script property is an informative property of the Unicode Standard. See also the getScript() method.
enum EastAsianWidth { NeutralWidth,
AmbiguousWidth,
HalfWidth,
FullWidth,
NarrowWidth,
WideWidth
};
An enumeration used to describe the display cell width of characters in East Asian text. The values in this enumeration correspond to the East Asian width property values defined in the EastAsianWidth.txt file Unicode Character Database (UCD), as described in Unicode Standard Annex #11, "East Asian Width":
http://www.unicode.org/unicode/reports/tr11
In accordance with changes to the Unicode specification for East Asian Width values, the ICU implementation changed between versions 2.4 and 2.6. Prior to ICU 2.6 (June 2003), the SourcePro Core Internationalization Module used the following declaration for EastAsianWidth:
enum EastAsianWidth { ZeroWidth,
HalfWidth,
FullWidth,
NeutralWidth,
EastAsianWidthCount
};
NOTE -- The Internationalization Module adopts the set of values that is supported by the underlying ICU implementation.
enum CombiningClass { BeginCombiningClass,
BaseEquivalent = BeginCombiningClass,
Spacing = BaseEquivalent,
Nonspacing = BaseEquivalent,
Split = BaseEquivalent,
Enclosing = BaseEquivalent,
Reordrant = BaseEquivalent,
TibetanSubjoined = BaseEquivalent,
OverlayInterior,
Nuktas,
KanaVoicingMarks,
Viramas,
StartOfFixedPositionClasses,
HebrewPointSheva =
StartOfFixedPositionClasses,
HebrewPointHatafSegol,
HebrewPointHatafPatah,
HebrewPointHatafQamats,
HebrewPointHiriq,
HebrewPointTsere,
HebrewPointSegol,
HebrewPointPatah,
HebrewPointQamats,
HebrewPointHolam,
HebrewPointQubuts,
HebrewPointDagishOrMapiq,
HebrewPointMeteg,
HebrewPointRafe,
HebrewPointShinDot,
HebrewPointSinDot,
HebrewPointJudeoSpanishVarika,
ArabicFathatan,
ArabicDammatan,
ArabicKasratan,
ArabicFatha,
ArabicDamma,
ArabicKasra,
ArabicShadda,
ArabicSukun,
ArabicLetterSuperscriptAlef,
SyriacLetterSuperscriptAlaph,
TeluguLengthMark,
TeluguAiLengthMark,
ThaiCharacterSaraU,
ThaiCharacterSaraUu =
ThaiCharacterSaraU,
ThaiCharacterMaiEk,
ThaiCharacterMaiTho =
ThaiCharacterMaiEk,
ThaiCharacterMaiTri =
ThaiCharacterMaiEk,
ThaiCharacterMaiChattawa =
ThaiCharacterMaiEk,
LaoVowelSignU,
LaoVowelSignUu = LaoVowelSignU,
LaoToneMaiEk,
LaoToneMaiTho = LaoToneMaiEk,
LaoToneMaiTi = LaoToneMaiEk,
LaoToneMaiCatawa = LaoToneMaiEk,
TibetanVowelSignAa,
TibetanVowelSignI,
TibetanVowelSignE = TibetanVowelSignI,
TibetanVowelSignEe = TibetanVowelSignI,
TibetanVowelSignO = TibetanVowelSignI,
TibetanVowelSignOo = TibetanVowelSignI,
TibetanVowelSignReversedI
TibetanVowelSignU,
EndOfFixedPositionClasses,
BelowLeftAttached,
BelowAttached,
BelowRightAttached,
LeftAttached,
RightAttached,
AboveLeftAttached,
AboveAttached,
AboveRightAttached,
BelowLeft,
Below,
BelowRight,
Left,
Right,
AboveLeft,
Above,
AboveRight,
DoubleBelow,
DoubleAbove,
IotaSubscript,
EndCombiningClass,
NoCombiningClass
};
An enumeration used to identify the combining class property to which each Unicode combining character belongs. See Chapter 3, "Conformance", and Chapter 4, "Character Properties", in the Unicode Standard:
http://www.unicode.org/unicode/standard/standard.html
The combining class property is a normative property of the Unicode Standard. The numeric value of each combining class and the number of classes are not normative and may change in future versions of the Unicode Standard. See also the getCombiningClass() method.
NOTE -- Some of the combining classes in this enumeration do not currently describe any Unicode characters but are specified here for completeness.
Static Member Functions
static BidirectionalCategory getBidirectionalCategory(RWUChar32 cp);
Returns the value of the bidirectional category property for the Unicode character whose code point is equal to cp. A value of NoBidirectionalCategory is returned if cp is not a valid character. The directional type of a character is defined in the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
The bidirectional property is a normative property of the Unicode Standard.
static Block getBlock(RWUChar32 cp);
Returns the value in the Block enumeration that identifies the character block which contains the Unicode character whose code point is equal to cp. A value of NoBlock is returned if cp is not a valid character. The character block is determined using information in the Blocks.txt file of the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
as described in Chapter 14, "Code Charts" of the Unicode Standard:
http://www.unicode.org/unicode/standard/standard.html
The block property is an informative property of the Unicode Standard.
static RWUChar32 getChar32(const char* name, bool isDeprecatedName = false);
Returns the code point of the Unicode character whose character name property value is equal to the value given for name. Returns a value of 0xFFFF, if no character whose name is name exists.
Each character may have two different names; a deprecated name, as originally defined by Unicode 1.0, and a standard name, as defined in subsequent versions of the standard. These names are defined in the UnicodeData.txt file of the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
isDeprecatedName equals true indicates that name is a character name defined in Version 1.0 of the Unicode Standard; false indicates that name is a character name defined in Version 2.0 and subsequent versions of the Unicode Standard. The default value is false.
The character name property is a normative property of the Unicode Standard.
Throws RWUException if an error occurs.
static CombiningClass getCombiningClass(RWUChar32 cp);
Returns the value of the combining class property for the Unicode character whose code point is cp. Each combining character is assigned a number that identifies the set containing all of the combining characters it typographically interacts with. See Chapter 3, "Conformance", of the Unicode Standard:
http://www.unicode.org/unicode/standard/standard.html
The combining class property is a normative property of the Unicode Standard. The numeric value of each combining class and the number of classes are not normative and may change in future versions of the Unicode Standard. The relative ordering of the classes is normative.
static int32_t getDecimalValue(RWUChar32 cp);
Returns the value of the decimal digit property for the Unicode character whose code point is equal to cp, if that character possesses the decimal digit property; otherwise, -1. The numeric value of a decimal digit is determined using information in the file UnicodeData.txt as described in:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
See Chapter 3, "Conformance", and Chapter 4, "Character Properties", of the Unicode Standard:
http://www.unicode.org/unicode/standard/standard.html
The decimal digit value property is a normative property of the Unicode Standard.
static RWUChar32 getDigit(int32_t value, int8_t radix);
Returns the RWUChar32 code point corresponding to the ASCII character in the range [0-9a-z]. Converts an integer value into a corresponding ASCII alphanumeric digit, given some radix in the range 2-36. value must be in the range 0 <= digit <= radix. For example, RWUCharTraits::getDigit(15, 16) returns the code point for f (U+0066).
In case of invalid value or invalid radix or the combination, returns null.
static EastAsianWidth getEastAsianWidth(RWUChar32 cp);
choseong - the leading consonants or initial characters of a syllable.
jungseong - the vowels or peak characters of a syllable.
jongseong - the trailing consonants or final characters of a syllable.
Returns the value of the East Asian width property for the Unicode character whose code point is equal to cp. The display cell width of an East-Asian character is determined using information in the file EastAsianWidth.txt of the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
as described in:
http://www.unicode.org/Public/UNIDATA/DerivedProperties.html
The Unicode Standard contains a complete set of precomposed modern Hangul syllables, as well as the set of conjoining jamo characters required to encode both modern and archaic syllable blocks. The Hangul jamo characters can be organized into the following classes:
When used with Korean Hangul, this function treats choseong jamo as double-width characters, and jungseong and jongseong jamo as zero-width characters. The result is correct only if the specified character is a precomposed choseong character and not part of a sequence of two choseong characters.
The East Asian width property is an informative property of the Unicode Standard. For more information, see Unicode Technical Report #11, "East Asian Character Width":
http://www.unicode.org/unicode/reports/tr11
and Chapter 10, "East Asian Scripts", in the Unicode Standard:
http://www.unicode.org/unicode/standard/standard.html
static GeneralCategory getGeneralCategory(RWUChar32 cp);
Returns the value of the general category property for the Unicode character whose code point is cp. Character categories are assigned in the file UnicodeData.txt of the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
as described in
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
The general category property is a normative property of the Unicode Standard. For more information, see Chapter 4 "Character Properties" in the Unicode Standard:
static RWUChar32 getMirror(RWUChar32 cp);
Returns the code point of the character that provides a "mirror-image" of the Unicode character whose code point is cp, as defined by the Unicode Standard, or the value of cp, if no such character exists. The mirror for cp is determined using information in the file BidiMirroring.txt of the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
as described in Unicode Standard Annex #9, "The Bidirectional Algorithm":
http://www.unicode.org/unicode/reports/tr9
For more information, see Chapter 4 "Character Properties" in the Unicode Standard:
http://www.unicode.org/unicode/standard/standard.html
See also the isMirrored() method.
static RWCString getName(RWUChar32 cp, bool getDeprecatedName = false);
Returns the value of the character name property for the Unicode character whose code point is cp.
The name property is a normative property of the Unicode Standard.
static int32_t getNumericValue(RWUChar32 cp, int8_t radix);
If radix is not the range 2-36, or if the value of cp is not a valid digit in that radix, then -1 is returned.
If the character cp is listed as a digit in the UnicodeData.txt file of the Unicode Character Database, and the decimal value given for that digit is less than the specified radix, then the decimal value of that digit is returned.
If the character cp is one of the uppercase Latin letters in the range A-Z and its code point value is less than (radix + 'A' - 10), then the value of the expression (cp - 'A' + 10) is returned.
If the character cp is one of the lowercase Latin letters in the range a-z and its code point value is less than (radix + 'a' - 10), then the value of the expression (cp - 'a' + 10) is returned.
Converts the code point cp of a digit character in the specified radix into an equivalent integer value.
Returns the numeric value of the character cp as follows:
static Script getScript(RWUChar32 cp);
Returns the value of the script property of the Unicode character whose code point is cp.
The script property is an informative property of the Unicode Standard.
static const RWUChar32* getWhitespace();
Returns a null-terminated array of code points that are reasonably considered to be a word break or whitespace. The list of such code points is provided only as a convenience for use as delimiters (see RWUTokenizer). See also isWhitespace().
Whitespace is not a property of the Unicode standard.
static bool isCharacter(RWUChar32 cp);
Returns true if cp is a valid Unicode character code point; otherwise, false. The range of Unicode code points is 0x0 - 0x10FFFF; however, some values within this range are reserved and are not valid characters.
The character property is a normative property of the Unicode Standard.
static bool isControl(RWUChar32 cp);
ISO 8-bit control characters (U+0000..U+001f and U+007f..U+009f)
Characters assigned to the Cc (Other, control) category
Characters assigned to the Cf (Other, format) category
Characters assigned to the Zl (Separator, line) category
Characters assigned to the Zp (Separator, paragraph) category
Returns true if cp is a code point for a control character; otherwise, false. The set of control characters is:
This set is defined in the UnicodeData.txt file of the Unicode Character Database, as described in:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
The control property is a normative property of the Unicode Standard.
static bool isDecimalDigit(RWUChar32 cp);
Returns true if cp is a code point for a decimal digit; otherwise, false. Decimal digits are identified using information in the file
http://www.unicode.org/Public/UNIDATA/UnicodeData.txt
according to the method described in
http://www.unicode.org/Public/UNIDATA/DerivedProperties.html
The decimal digit property is a normative property of the Unicode Standard.
static bool isDefined(RWUChar32 cp);
Returns true if cp is the code point for a character named in the Unicode Character Database. A defined character is assigned various properties under the Unicode Standard. These properties can be accessed using the methods provided by this class.
The defined property is a normative property of the Unicode Standard.
static bool isDigit(RWUChar32 cp);
Returns true if cp is a code point for a digit; otherwise, false. Digits are identified using information in the file UnicodeData.txt of the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
according to the method described in
http://www.unicode.org/Public/UNIDATA/DerivedProperties.html
The digit property is a normative property of the Unicode Standard. See also isDecimalDigit(), and isNumeric().
static bool isError(RWUChar32 cp);
Returns true if cp is an error code and not a valid character code point; otherwise, false. Some RWUChar32 values have been reserved for use in reporting errors.
The error property is a private, implementation-defined property allowed by the Unicode Standard.
static bool isHighSurrogate(RWUChar16 cu);
Returns true if cu is the first, or high, code unit of a surrogate pair; otherwise, false. A high surrogate has a value in the range [U+D800..U+DBFF].
The surrogate property is a normative property of the Unicode Standard. See also isSurrogate(), isLowSurrogate(), and isSingle().
static bool isLetter(RWUChar32 cp);
refers to a valid character in the file UnicodeData.txt of the Unicode Character Database, and the general category property for that character is one of Ll, Lu, Lt, Lm, or Lo, as described in
is listed in the "Other_Alphabetic" section of the PropList.txt file, as described in
Returns true if cp is a code point for a letter; otherwise, false. The value of cp is the code point for a letter if it:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
http://www.unicode.org/Public/UNIDATA/PropList.html
The letter property is an informative property of the Unicode Standard. See also getGeneralCategory() and isDigit().
static bool isLower(RWUChar32 cp);
Returns true if cp is a code point for a lowercase letter; otherwise, false. The value is the code point for a lowercase letter if it refers to a valid character in the file UnicodeData.txt of the Unicode Character Database, and the general category property for that character is Ll, as described in:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
The lowercase property is a normative property of the Unicode Standard. See also getGeneralCategory(), isUpper(), and isTitle().
static bool isLowSurrogate(RWUChar16 cu);
Returns true if cu is the second, or low, code unit of a surrogate pair; otherwise, false. A low-surrogate has a value in the range [U+DC00..U+DFFF].
The surrogate property is a normative property of the Unicode Standard.
static bool isMirrored(RWUChar32 cp);
Returns true if cp is a code point for a mirrored character; otherwise, false. Mirroring is a property of characters, such as parentheses, whose images are reflected horizontally in text that is laid out right to left. For example, the left parens is the opening parens in left-to-right text, but in right-to-left text the mirrored right parens is the opening parens. The Unicode mirrored property is described in Unicode Standard Annex #9, "The Bidirectional Algorithm":
http://www.unicode.org/unicode/reports/tr9/
The mirrored property is a normative property of the Unicode Standard.
static bool isNumeric(RWUChar32 cp);
Returns true if cp is a code point for a numeric character; otherwise, false. The set of numeric characters is a superset of the set of digit characters, and includes additional characters such as vulgar fractions and Roman numerals.
Numeric characters are identified using information in the UnicodeData.txt file of the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
according to the method described in
http://www.unicode.org/Public/UNIDATA/DerivedProperties.html
The numeric property is a normative property of the Unicode Standard.
static bool isPunctuation(RWUChar32 cp);
Returns true if cp is a code point for a punctuation character; otherwise, false.
Punctuation characters are identified using information in the UnicodeData.txt file of the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
according to the method described in
http://www.unicode.org/Public/UNIDATA/DerivedProperties.html
The punctuation property is a normative property of the Unicode Standard.
static bool isSingle(RWUChar16 cu);
Returns true if cu is a code unit that corresponds to a single code point, or false if the value is either part of a surrogate pair consisting of two code units.
The surrogate property is a normative property of the Unicode Standard. See also isSurrogate(), isHighSurrogate(), and isLowSurrogate().
static bool isSpace(RWUChar32 cp);
Returns true if cp is a code point for a spacing character; otherwise, false. Space characters are identified in the Unicode Character Database:
http://www.unicode.org/Public/UNIDATA/UnicodeCharacterDatabase.html
as described in:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
The space property is an informative property of the Unicode Standard.
static bool isSurrogate(RWUChar16 cu);
Returns true if cu is a surrogate in the range U+D800 through U+DFFF; otherwise, false.
Surrogates are not characters; they are reserved for use in UTF-16 strings as leading and trailing code units of multi-unit sequences used to encode single code points.
The surrogate property is a normative property of the Unicode Standard.
See also isSingle(), isHighSurrogate(), and isLowSurrogate().
static bool isTitle(RWUChar32 cp);
Returns true if cp is a code point for a titlecase letter; otherwise, false. The value is the code point for a titlecase letter if it refers to a valid character in the file UnicodeData.txt of the Unicode Character Database, and the general category property for that character is Lu or Lt, as described in
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
The titlecase property is a normative property of the Unicode Standard.
static bool isUpper(RWUChar32 cp);
refers to a valid character in the file UnicodeData.txt of the Unicode Character Database, and the general category property for that character is Lu, as described in
is listed in the "Other_Uppercase" section of the PropList.txt file, as described in
Returns true if cp is a code point for an uppercase letter; otherwise, false. The value is a code point for an uppercase letter if it either:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
http://www.unicode.org/Public/UNIDATA/PropList.html
The uppercase property is a normative property of the Unicode Standard.
static bool isWhitespace(RWUChar32 cp);
Returns true if cp is recognized as whitespace. See also getWhitespace().
Whitespace is not a property of the Unicode Standard.
static bool requiresSurrogatePair(RWUChar32 cp);
Returns true if cp is greater than 0xFFFF and therefore would require a surrogate representation; otherwise, false
Surrogates are a normative requirement of the Unicode Standard.
NOTE -- For efficiency, this method does not check whether the given code point is valid.
static RWUChar32 toLower(RWUChar32 cp);
Returns the lowercase equivalent for the given character code point cp. If the code point has no lowercase equivalent, the code point itself is returned. The character is mapped to its lowercase equivalent using information in the Unicode Character Database, as described in:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
This method can only handle simple case conversions. For locale-specific case conversions, use RWUString::toLower().
The case property is a normative property of the Unicode Standard. The lowercase mapping is an informative property of the Unicode Standard.
This method is equivalent to the ANSI/ISO-C toLower() function.
static RWUChar32 toTitle(RWUChar32 cp);
Returns the titlecase equivalent for cp. The titlecase mapping of a character is determined using information in the file UnicodeData.txt of the Unicode Character Database, as described in:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
If the character has no titlecase equivalent, the character itself is returned.
The case property is a normative property of the Unicode Standard. A titlecase mapping is an informative property of the Unicode Standard.
NOTE -- This method can only map characters that map to a single character. This method cannot be used for mappings where the source character maps to more than one character, or where the mapping is context-dependent. The single character mappings provided by this method are insufficient for languages such as German. For full case mappings, use RWUString::toTitle().
static RWUChar32 toUpper(RWUChar32 cp);
Returns the uppercase equivalent for cp. The character is mapped to its uppercase equivalent using information in the Unicode Character Database, as described in:
http://www.unicode.org/Public/UNIDATA/UnicodeData.html
If the code point has no uppercase equivalent, the code point itself is returned.
This method can only perform general letter case conversion. For language-specific case conversions, use RWUString::toUpper().
The case property is a normative property of the Unicode Standard. An uppercase mapping is an informative property of the Unicode Standard.
This method is equivalent to the ANSI/ISO-C toUpper() function.
© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.