Int64::Parse Method (String^)

.NET Framework (current version)

Converts the string representation of a number to its 64-bit signed integer equivalent.

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

Syntax

public:
static long long Parse(
	String^ s
)

Parameters

s: Type: System::String^
A string containing a number to convert.

Return Value

Type: System::Int64

A 64-bit signed integer equivalent to the number contained in s.

Exceptions

Exception	Condition
ArgumentNullException	s is null.
FormatException	s is not in the correct format.
OverflowException	s represents a number less than MinValue or greater than MaxValue.

Remarks

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 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 Int64::Parse(String^, NumberStyles) or the Int64::Parse(String^, NumberStyles, IFormatProvider^) method.

The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. To parse a string using the formatting information of some other culture, use the Int64::Parse(String^, NumberStyles, IFormatProvider^) method.

Examples

The following example demonstrates how to convert a string value into a 64-bit signed integer value using the Int64::Parse(String^) method. It then displays the resulting long integer value.

C++

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

Version Information

Universal Windows Platform
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