Struct long

Namespace

System

Assembly

mscorlib.dll

Represents a 64-bit signed integer.

public long

Inherited Members

ValueType.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

object.GetType()

Fields

MaxValue

Represents the largest possible value of an Int64. This field is constant.

public const long MaxValue = 9223372036854775807

Field Value

long

Remarks

The value of this constant is 9,223,372,036,854,775,807; that is, hexadecimal 0x7FFFFFFFFFFFFFFF.

MinValue

Represents the smallest possible value of an Int64. This field is constant.

public const long MinValue = -9223372036854775808

Field Value

long

Remarks

The value of this constant is negative 9,223,372,036,854,775,808; that is, hexadecimal 0x8000000000000000.

Methods

Parse(string)

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

public static long Parse(string s)

Parameters

s string

A string containing a number to convert.

Returns

long

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

Exceptions

ArgumentNullException

s is null.

ToString()

Converts the numeric value of this instance to its equivalent string representation.

public override string ToString()

Returns

string

The string representation of the value of this instance, consisting of a minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

ToString(string)

Converts the numeric value of this instance to its equivalent string representation, using the specified format.

public string ToString(string format)

Parameters

format string

A numeric format string.

Returns

string

The string representation of the value of this instance as specified by format.

TryParse(string, out long)

Converts the string representation of a number to its 64-bit signed integer equivalent. A return value indicates whether the conversion succeeded.

public static bool TryParse(string s, out long result)

Parameters

s string

Converts the string representation of a number to its 64-bit signed integer equivalent. A return value indicates whether the conversion succeeded.

result long

When this method returns, contains the 64-bit signed integer value equivalent of the number contained in s, if the conversion succeeded, or zero if the conversion failed. The conversion fails if the s parameter is null or Empty, is not of the correct format, or represents a number less than MinValue or greater than MaxValue. This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Returns

bool

true if s was converted successfully; otherwise, false.

Remarks

The TryParse(string, out long) method is like the Parse(string) method, except the TryParse(string, out long) method does not throw an exception if the conversion fails. It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.