Math.Abs Method (Int64) (System)

Switch View :
Classic
Lightweight
ScriptFree
.NET Framework Class Library
Math.Abs Method (Int64)

Updated: July 2010

Returns the absolute value of a 64-bit signed integer.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
Syntax
Visual Basic
Public Shared Function Abs ( _
	value As Long _
) As Long
C#
public static long Abs(
	long value
)
Visual C++
public:
static long long Abs(
	long long value
)
F#
static member Abs : 
        value:int64 -> int64

Parameters

value
Type: System.Int64
A number that is greater than Int64.MinValue, but less than or equal to Int64.MaxValue.

Return Value

Type: System.Int64
A 64-bit signed integer, x, such that 0 ≤ x ≤ Int64.MaxValue.
Exceptions
Exception Condition
OverflowException

value equals Int64.MinValue.

Remarks

The absolute value of an Int64 is its numeric value without its sign. For example, the absolute value of both 123 and -123 is 123.

Examples

The following example uses the Abs(Int64) method to get the absolute value of a number of Int64 values.

Visual Basic

Dim values() As Long = { Int64.MaxValue, 109013, 0, -6871982, Int64.MinValue }
For Each value As Long In values
   Try
      Console.WriteLine("Abs({0}) = {1}", value, Math.Abs(value))
   Catch e As OverflowException
      Console.WriteLine("Unable to calculate the absolute value of {0}.", _
                        value)
   End Try   
Next
' The example displays the following output:
'       Abs(9223372036854775807) = 9223372036854775807
'       Abs(109013) = 109013
'       Abs(0) = 0
'       Abs(-6871982) = 6871982
'       Unable to calculate the absolute value of -9223372036854775808.
C#

long[] values = { Int64.MaxValue, 109013, 0, -6871982, Int64.MinValue };
foreach (long value in values)
{
   try {
      Console.WriteLine("Abs({0}) = {1}", value, Math.Abs(value));
   }   
   catch (OverflowException) {
      Console.WriteLine("Unable to calculate the absolute value of {0}.", 
                        value);
   }
}
// The example displays the following output:
//       Abs(9223372036854775807) = 9223372036854775807
//       Abs(109013) = 109013
//       Abs(0) = 0
//       Abs(-6871982) = 6871982
//       Unable to calculate the absolute value of -9223372036854775808.
Version Information

.NET Framework

Supported in: 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
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Reference

Math Class
Abs Overload
System Namespace
Change History

Date

History

Reason

July 2010

Added a definition of absolute value.

Customer feedback.