Export (0) Print
Expand All

Char::IsNumber Method (Char)

Indicates whether the specified Unicode character is categorized as a number.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public:
static bool IsNumber(
	wchar_t c
)

Parameters

c
Type: System::Char

The Unicode character to evaluate.

Return Value

Type: System::Boolean
true if c is a number; otherwise, false.

This method determines whether a Char is of any numeric Unicode category. In addition to including digits, numbers include characters, fractions, subscripts, superscripts, Roman numerals, currency numerators, and encircled numbers. This method contrasts with the IsDigit method, which determines whether a Char is a radix-10 digit.

Valid numbers are members of the UnicodeCategory::DecimalDigitNumber, UnicodeCategory::LetterNumber, or UnicodeCategory::OtherNumber category.

The IsNumber(Char) method assumes that c corresponds to a single linguistic character and checks whether that character represents a number. 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 IsNumber(Char) method returns false if it is passed either a high surrogate or a low surrogate of this character.

No code example is currently available or this language may not be supported.

The following example demonstrates IsNumber.

using namespace System;
int main()
{
   String^ str =  "non-numeric";
   Console::WriteLine( Char::IsNumber( '8' ) ); // Output: "True"
   Console::WriteLine( Char::IsNumber( str, 3 ) ); // Output: "False"
}

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft