CharUnicodeInfo::GetNumericValue Method (Char)
Gets the numeric value associated with the specified character.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- ch
- Type: System::Char
The Unicode character for which to get the numeric value.
Return Value
Type: System::DoubleThe numeric value associated with the specified character.
-or-
-1, if the specified character is not a numeric character.
Numeric value is a Unicode character property that applies only to numeric characters, which include fractions, subscripts, superscripts, Roman numerals, currency numerators, encircled numbers, and script-specific digits. For more information on Unicode characters, see the Unicode Standard.
The GetNumericValue method assumes that ch corresponds to a single linguistic character and checks whether that character can be converted to a decimal digit. However, some numbers in the Unicode standard are represented by two Char objects that form a surrogate pair. For example, the Aegean numbering system consists of code points U+10107 through U+10133. The following example uses the ConvertFromUtf32 method to instantiate a string that represents AEGEAN NUMBER ONE. As the output from the example shows, the GetNumericValue method returns -1 if it is passed either a high surrogate or a low surrogate of this character.
The following code example shows the values returned by each method for different types of characters.
using namespace System; using namespace System::Globalization; void PrintProperties( Char c ); int main() { Console::WriteLine( " c Num Dig Dec UnicodeCategory" ); Console::Write( "U+0061 LATIN SMALL LETTER A " ); PrintProperties( L'a' ); Console::Write( "U+0393 GREEK CAPITAL LETTER GAMMA " ); PrintProperties( L'\u0393' ); Console::Write( "U+0039 DIGIT NINE " ); PrintProperties( L'9' ); Console::Write( "U+00B2 SUPERSCRIPT TWO " ); PrintProperties( L'\u00B2' ); Console::Write( "U+00BC VULGAR FRACTION ONE QUARTER " ); PrintProperties( L'\u00BC' ); Console::Write( "U+0BEF TAMIL DIGIT NINE " ); PrintProperties( L'\u0BEF' ); Console::Write( "U+0BF0 TAMIL NUMBER TEN " ); PrintProperties( L'\u0BF0' ); Console::Write( "U+0F33 TIBETAN DIGIT HALF ZERO " ); PrintProperties( L'\u0F33' ); Console::Write( "U+2788 CIRCLED SANS-SERIF DIGIT NINE " ); PrintProperties( L'\u2788' ); } void PrintProperties( Char c ) { Console::Write( " {0,-3}", c ); Console::Write( " {0,-5}", CharUnicodeInfo::GetNumericValue( c ) ); Console::Write( " {0,-5}", CharUnicodeInfo::GetDigitValue( c ) ); Console::Write( " {0,-5}", CharUnicodeInfo::GetDecimalDigitValue( c ) ); Console::WriteLine( "{0}", CharUnicodeInfo::GetUnicodeCategory( c ) ); } /* This code produces the following output. Some characters might not display at the console. c Num Dig Dec UnicodeCategory U+0061 LATIN SMALL LETTER A a -1 -1 -1 LowercaseLetter U+0393 GREEK CAPITAL LETTER GAMMA \u0393 -1 -1 -1 UppercaseLetter U+0039 DIGIT NINE 9 9 9 9 DecimalDigitNumber U+00B2 SUPERSCRIPT TWO \u00B2 2 2 2 OtherNumber U+00BC VULGAR FRACTION ONE QUARTER \u00BC 0.25 -1 -1 OtherNumber U+0BEF TAMIL DIGIT NINE \u0BEF 9 9 9 DecimalDigitNumber U+0BF0 TAMIL NUMBER TEN \u0BF0 10 -1 -1 OtherNumber U+0F33 TIBETAN DIGIT HALF ZERO \u0F33 -0.5 -1 -1 OtherNumber U+2788 CIRCLED SANS-SERIF DIGIT NINE \u2788 9 9 -1 OtherNumber */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.