CharUnicodeInfo::GetDigitValue Method (String^, Int32)
Gets the digit value of the numeric character at the specified index of the specified string.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- s
-
Type:
System::String^
The String containing the Unicode character for which to get the digit value.
- index
-
Type:
System::Int32
The index of the Unicode character for which to get the digit value.
Return Value
Type: System::Int32The digit value of the numeric character at the specified index of the specified string.
-or-
-1, if the character at the specified index of the specified string is not a digit.
| Exception | Condition |
|---|---|
| ArgumentNullException | s is null. |
| ArgumentOutOfRangeException | index is outside the range of valid indexes in s. |
Digit value is a property that applies only to numeric characters that can be used as digits. A digit is a numeric character that can be combined with other digits to represent a whole number in a numbering system.
For more information on 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; int main() { // The String to get information for. String^ s = "a9\u0393\u00B2\u00BC\u0BEF\u0BF0\u2788"; Console::WriteLine( "String: {0}", s ); // Print the values for each of the characters in the string. Console::WriteLine( "index c Num Dig Dec UnicodeCategory" ); for ( int i = 0; i < s->Length; i++ ) { Console::Write( "{0,-5} {1,-3}", i, s[ i ] ); Console::Write( " {0,-5}", CharUnicodeInfo::GetNumericValue( s, i ) ); Console::Write( " {0,-5}", CharUnicodeInfo::GetDigitValue( s, i ) ); Console::Write( " {0,-5}", CharUnicodeInfo::GetDecimalDigitValue( s, i ) ); Console::WriteLine( "{0}", CharUnicodeInfo::GetUnicodeCategory( s, i ) ); } } /* This code produces the following output. Some characters might not display at the console. String: a9\u0393\u00B2\u00BC\u0BEF\u0BF0\u2788 index c Num Dig Dec UnicodeCategory 0 a -1 -1 -1 LowercaseLetter 1 9 9 9 9 DecimalDigitNumber 2 \u0393 -1 -1 -1 UppercaseLetter 3 \u00B2 2 2 2 OtherNumber 4 \u00BC 0.25 -1 -1 OtherNumber 5 \u0BEF 9 9 9 DecimalDigitNumber 6 \u0BF0 10 -1 -1 OtherNumber 7 \u2788 9 9 -1 OtherNumber */
Available since 2.0