CharUnicodeInfo::GetDecimalDigitValue Method (Char)
Gets the decimal digit value of the specified numeric character.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- ch
-
Type:
System::Char
The Unicode character for which to get the decimal digit value.
Return Value
Type: System::Int32The decimal digit value of the specified numeric character.
-or-
-1, if the specified character is not a decimal digit.
This method converts characters that represent decimal digits to their equivalent integral values. Decimal digits are characters in the DecimalDigitNumber category that can represent one of ten digits in the decimal (base 10) numbering system, from zero through nine. It includes characters such as U+0030 (DIGIT ZERO) through U+0039 (DIGIT NINE), U+0660 (ARABIC-INDIC DIGIT ZERO) through U+0669 (ARABIC-INDIC DIGIT NINE), U+07C0 (NKO DIGIT ZERO) through U+07C9 (NKO DIGIT NINE), and U+1040 (MYANMAR DIGIT ZERO) through U+1049 (MYANMAR DIGIT NINE).
For more information about Unicode characters, see the Unicode Standard.
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 */
Available since 2.0