Int16::Parse Method (String^)
Converts the string representation of a number to its 16-bit signed integer equivalent.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- s
-
Type:
System::String^
A string containing a number to convert.
| Exception | Condition |
|---|---|
| ArgumentNullException | s is null. |
| FormatException | s is not in the correct format. |
| OverflowException |
The s parameter contains a number of the form:
[ws][sign]digits[ws]
Elements in square brackets ([ and ]) are optional. The following table describes each element.
Element | Description |
|---|---|
ws | Optional white space. |
sign | An optional sign. |
digits | A sequence of digits ranging from 0 to 9. |
The s parameter is interpreted using the NumberStyles::Integer style. In addition to the integer value's decimal digits, only leading and trailing spaces together with a leading sign are allowed. To explicitly define the style elements that can be present in s, use either the Int16::Parse(String^, NumberStyles) or the Parse method.
The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. For more information, see CurrentInfo. To parse a string using the formatting information of some other culture, use the Int16::Parse(String^, IFormatProvider^) or the Int16::Parse(String^, NumberStyles, IFormatProvider^) method.
The following example demonstrates how to convert a string value into a 16-bit signed integer value using the Int16::Parse(String^) method. The resulting integer value is then displayed to the console.
String^ value; Int16 number; value = " 12603 "; try { number = Int16::Parse(value); Console::WriteLine("Converted '{0}' to {1}.", value, number); } catch (FormatException ^e) { Console::WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", value); } value = " 16,054"; try { number = Int16::Parse(value); Console::WriteLine("Converted '{0}' to {1}.", value, number); } catch (FormatException ^e) { Console::WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", value); } value = " -17264"; try { number = Int16::Parse(value); Console::WriteLine("Converted '{0}' to {1}.", value, number); } catch (FormatException ^e) { Console::WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", value); } // The example displays the following output to the console: // Converted ' 12603 ' to 12603. // Unable to convert ' 16,054' to a 16-bit signed integer. // Converted ' -17264' to -17264.
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1