# Math.Abs Method

## Definition

Returns the absolute value of a specified number.

 Abs(Decimal) Returns the absolute value of a Decimal number. Abs(Double) Returns the absolute value of a double-precision floating-point number. Abs(Int16) Returns the absolute value of a 16-bit signed integer. Abs(Int32) Returns the absolute value of a 32-bit signed integer. Abs(Int64) Returns the absolute value of a 64-bit signed integer. Abs(IntPtr) Returns the absolute value of a native signed integer. Abs(SByte) Returns the absolute value of an 8-bit signed integer. Abs(Single) Returns the absolute value of a single-precision floating-point number.

## Abs(Decimal)

Returns the absolute value of a Decimal number.

public:
static System::Decimal Abs(System::Decimal value);
public static decimal Abs (decimal value);
static member Abs : decimal -> decimal
Public Shared Function Abs (value As Decimal) As Decimal

#### Parameters

value
Decimal

A number that is greater than or equal to Decimal.MinValue, but less than or equal to Decimal.MaxValue.

#### Returns

Decimal

A decimal number, x, such that 0 ≤ x ≤ Decimal.MaxValue.

### Examples

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

decimal[] decimals = { Decimal.MaxValue, 12.45M, 0M, -19.69M,
Decimal.MinValue };
foreach (decimal value in decimals)
Console.WriteLine(\$"Abs({value}) = {Math.Abs(value)}");

// The example displays the following output:
//       Abs(79228162514264337593543950335) = 79228162514264337593543950335
//       Abs(12.45) = 12.45
//       Abs(0) = 0
//       Abs(-19.69) = 19.69
//       Abs(-79228162514264337593543950335) = 79228162514264337593543950335
open System

let decimals =
[ Decimal.MaxValue; 12.45M; 0M
-19.69M; Decimal.MinValue ]

for value in decimals do
// The 'abs' function may be used instead.
printfn \$"Abs({value}) = {Math.Abs value}"

// The example displays the following output:
//       Abs(79228162514264337593543950335) = 79228162514264337593543950335
//       Abs(12.45) = 12.45
//       Abs(0) = 0
//       Abs(-19.69) = 19.69
//       Abs(-79228162514264337593543950335) = 79228162514264337593543950335
Module Example
Public Sub Main()
Dim decimals() As Decimal = { Decimal.MaxValue, 12.45D, 0D, -19.69D, _
Decimal.MinValue }
For Each value As Decimal In decimals
Console.WriteLine("Abs({0}) = {1}", value, Math.Abs(value))
Next
End Sub
End Module
' The example displays the following output:
'       Abs(79228162514264337593543950335) = 79228162514264337593543950335
'       Abs(12.45) = 12.45
'       Abs(0) = 0
'       Abs(-19.69) = 19.69
'       Abs(-79228162514264337593543950335) = 79228162514264337593543950335

### Remarks

The absolute value of a Decimal is its numeric value without its sign. For example, the absolute value of both 1.2 and -1.2 is 1.2.

## Abs(Double)

Returns the absolute value of a double-precision floating-point number.

public:
static double Abs(double value);
public static double Abs (double value);
static member Abs : double -> double
Public Shared Function Abs (value As Double) As Double

#### Parameters

value
Double

A number that is greater than or equal to Double.MinValue, but less than or equal to Double.MaxValue.

#### Returns

Double

A double-precision floating-point number, x, such that 0 ≤ x ≤ Double.MaxValue.

### Examples

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

double[] doubles = { Double.MaxValue, 16.354e-17, 15.098123, 0,
-19.069713, -15.058e18, Double.MinValue };
foreach (double value in doubles)
Console.WriteLine(\$"Abs({value}) = {Math.Abs(value)}");

// The example displays the following output:
//       Abs(1.79769313486232E+308) = 1.79769313486232E+308
//       Abs(1.6354E-16) = 1.6354E-16
//       Abs(15.098123) = 15.098123
//       Abs(0) = 0
//       Abs(-19.069713) = 19.069713
//       Abs(-1.5058E+19) = 1.5058E+19
//       Abs(-1.79769313486232E+308) = 1.79769313486232E+308
open System

let doubles =
[ Double.MaxValue; 16.354e-17; 15.098123; 0
-19.069713; -15.058e18; Double.MinValue ]

for value in doubles do
// The 'abs' function may be used instead.
printfn \$"Abs({value}) = {Math.Abs value}"

// The example displays the following output:
//       Abs(1.79769313486232E+308) = 1.79769313486232E+308
//       Abs(1.6354E-16) = 1.6354E-16
//       Abs(15.098123) = 15.098123
//       Abs(0) = 0
//       Abs(-19.069713) = 19.069713
//       Abs(-1.5058E+19) = 1.5058E+19
//       Abs(-1.79769313486232E+308) = 1.79769313486232E+308
Module Example
Public Sub Main()
Dim doubles() As Double = { Double.MaxValue, 16.354e-17, 15.098123, 0, _
-19.069713, -15.058e18, Double.MinValue }
For Each value As Double In doubles
Console.WriteLine("Abs({0}) = {1}", value, Math.Abs(value))
Next
End Sub
End Module
' The example displays the following output:
'       Abs(1.79769313486232E+308) = 1.79769313486232E+308
'       Abs(1.6354E-16) = 1.6354E-16
'       Abs(15.098123) = 15.098123
'       Abs(0) = 0
'       Abs(-19.069713) = 19.069713
'       Abs(-1.5058E+19) = 1.5058E+19
'       Abs(-1.79769313486232E+308) = 1.79769313486232E+308

### Remarks

The absolute value of a Double is its numeric value without its sign. For example, the absolute value of both 1.2e03 and -1.2e03 is 1.2e03.

If value is equal to NegativeInfinity or PositiveInfinity, the return value is PositiveInfinity. If value is equal to NaN, the return value is NaN.

## Abs(Int16)

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

public:
static short Abs(short value);
public static short Abs (short value);
static member Abs : int16 -> int16
Public Shared Function Abs (value As Short) As Short

#### Parameters

value
Int16

A number that is greater than Int16.MinValue, but less than or equal to Int16.MaxValue.

#### Returns

Int16

A 16-bit signed integer, x, such that 0 ≤ x ≤ Int16.MaxValue.

#### Exceptions

value equals Int16.MinValue.

### Examples

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

short[] values = { Int16.MaxValue, 10328, 0, -1476, Int16.MinValue };
foreach (short value in values)
{
try {
Console.WriteLine(\$"Abs({value}) = {Math.Abs(value)}");
}
catch (OverflowException) {
Console.WriteLine("Unable to calculate the absolute value of {0}.",
value);
}
}

// The example displays the following output:
//       Abs(32767) = 32767
//       Abs(10328) = 10328
//       Abs(0) = 0
//       Abs(-1476) = 1476
//       Unable to calculate the absolute value of -32768.
open System

let values =
[ Int16.MaxValue; 10328s; 0s; -1476s; Int16.MinValue ]

for value in values do
try
// The 'abs' function may be used instead.
printfn \$"Abs({value}) = {Math.Abs value}"
with :? OverflowException ->
printfn \$"Unable to calculate the absolute value of {value}."

// The example displays the following output:
//       Abs(32767) = 32767
//       Abs(10328) = 10328
//       Abs(0) = 0
//       Abs(-1476) = 1476
//       Unable to calculate the absolute value of -32768.
Module Example
Public Sub Main()
Dim values() As Short = { Int16.MaxValue, 10328, 0, -1476, Int16.MinValue }
For Each value As Short 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
End Sub
End Module
' The example displays the following output:
'       Abs(32767) = 32767
'       Abs(10328) = 10328
'       Abs(0) = 0
'       Abs(-1476) = 1476
'       Unable to calculate the absolute value of -32768.

### Remarks

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

## Abs(Int32)

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

public:
static int Abs(int value);
public static int Abs (int value);
static member Abs : int -> int
Public Shared Function Abs (value As Integer) As Integer

#### Parameters

value
Int32

A number that is greater than Int32.MinValue, but less than or equal to Int32.MaxValue.

#### Returns

Int32

A 32-bit signed integer, x, such that 0 ≤ x ≤ Int32.MaxValue.

#### Exceptions

value equals Int32.MinValue.

### Examples

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

int[] values = { Int32.MaxValue, 16921, 0, -804128, Int32.MinValue };
foreach (int value in values)
{
try {
Console.WriteLine(\$"Abs({value}) = {Math.Abs(value)}");
}
catch (OverflowException) {
Console.WriteLine("Unable to calculate the absolute value of {0}.",
value);
}
}

// The example displays the following output:
//       Abs(2147483647) = 2147483647
//       Abs(16921) = 16921
//       Abs(0) = 0
//       Abs(-804128) = 804128
//       Unable to calculate the absolute value of -2147483648.
open System

let values =
[ Int32.MaxValue; 16921; 0; -804128; Int32.MinValue ]

for value in values do
try
// The 'abs' function may be used instead.
printfn \$"Abs({value}) = {Math.Abs(value)}"
with :? OverflowException ->
printfn \$"Unable to calculate the absolute value of {value}."

// The example displays the following output:
//       Abs(2147483647) = 2147483647
//       Abs(16921) = 16921
//       Abs(0) = 0
//       Abs(-804128) = 804128
//       Unable to calculate the absolute value of -2147483648.
Module Example
Public Sub Main()
Dim values() As Integer = { Int32.MaxValue, 16921, 0, -804128, Int32.MinValue }
For Each value As Integer 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
End Sub
End Module
' The example displays the following output:
'       Abs(2147483647) = 2147483647
'       Abs(16921) = 16921
'       Abs(0) = 0
'       Abs(-804128) = 804128
'       Unable to calculate the absolute value of -2147483648.

### Remarks

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

## Abs(Int64)

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

public:
static long Abs(long value);
public static long Abs (long value);
static member Abs : int64 -> int64
Public Shared Function Abs (value As Long) As Long

#### Parameters

value
Int64

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

#### Returns

Int64

A 64-bit signed integer, x, such that 0 ≤ x ≤ Int64.MaxValue.

#### Exceptions

value equals Int64.MinValue.

### Examples

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

long[] values = { Int64.MaxValue, 109013, 0, -6871982, Int64.MinValue };
foreach (long value in values)
{
try {
Console.WriteLine(\$"Abs({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.
open System

let values =
[ Int64.MaxValue; 109013; 0; -6871982; Int64.MinValue ]

for value in values do
try
// The 'abs' function may be used instead.
printfn \$"Abs({value}) = {Math.Abs value}"
with :? OverflowException ->
printfn \$"Unable to calculate the absolute value of {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.
Module Example
Public Sub Main()
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
End Sub
End Module
' 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.

### 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.

## Abs(IntPtr)

Returns the absolute value of a native signed integer.

public:
static IntPtr Abs(IntPtr value);
public static nint Abs (nint value);
public static IntPtr Abs (IntPtr value);
static member Abs : nativeint -> nativeint
Public Shared Function Abs (value As IntPtr) As IntPtr

#### Parameters

value

nint

nativeint

A number that is greater than MinValue, but less than or equal to MaxValue.

#### Returns

nint

nativeint

A native signed integer, x, such that 0 ≤ x ≤ MaxValue.

## Abs(SByte)

Important

This API is not CLS-compliant.

Returns the absolute value of an 8-bit signed integer.

public:
static System::SByte Abs(System::SByte value);
[System.CLSCompliant(false)]
public static sbyte Abs (sbyte value);
[<System.CLSCompliant(false)>]
static member Abs : sbyte -> sbyte
Public Shared Function Abs (value As SByte) As SByte

#### Parameters

value
SByte

A number that is greater than SByte.MinValue, but less than or equal to SByte.MaxValue.

#### Returns

SByte

An 8-bit signed integer, x, such that 0 ≤ x ≤ SByte.MaxValue.

Attributes

#### Exceptions

value equals SByte.MinValue.

### Examples

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

sbyte[] values = { SByte.MaxValue, 98, 0, -32, SByte.MinValue };
foreach (sbyte value in values)
{
try {
Console.WriteLine(\$"Abs({value}) = {Math.Abs(value)}");
}
catch (OverflowException) {
Console.WriteLine("Unable to calculate the absolute value of {0}.",
value);
}
}

// The example displays the following output:
//       Abs(127) = 127
//       Abs(98) = 98
//       Abs(0) = 0
//       Abs(-32) = 32
//       Unable to calculate the absolute value of -128.
open System

let values =
[ SByte.MaxValue; 98y; 0y; -32y; SByte.MinValue ]

for value in values do
try
// The 'abs' function may be used instead.
printfn \$"Abs({value}) = {Math.Abs value}"
with :? OverflowException ->
printfn \$"Unable to calculate the absolute value of {value}."

// The example displays the following output:
//       Abs(127) = 127
//       Abs(98) = 98
//       Abs(0) = 0
//       Abs(-32) = 32
//       Unable to calculate the absolute value of -128.
Module Example
Public Sub Main()
Dim values() As SByte = { SByte.MaxValue, 98, 0, -32, SByte.MinValue }
For Each value As SByte 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
End Sub
End Module
' The example displays the following output:
'       Abs(127) = 127
'       Abs(98) = 98
'       Abs(0) = 0
'       Abs(-32) = 32
'       Unable to calculate the absolute value of -128.

### Remarks

The absolute value of a signed byte is its numeric value without its sign. For example, the absolute value of both 12 and -12 is 12.

## Abs(Single)

Returns the absolute value of a single-precision floating-point number.

public:
static float Abs(float value);
public static float Abs (float value);
static member Abs : single -> single
Public Shared Function Abs (value As Single) As Single

#### Parameters

value
Single

A number that is greater than or equal to Single.MinValue, but less than or equal to Single.MaxValue.

#### Returns

Single

A single-precision floating-point number, x, such that 0 ≤ x ≤ Single.MaxValue.

### Examples

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

float[] values= { Single.MaxValue, 16.354e-12F, 15.098123F, 0F,
-19.069713F, -15.058e17F, Single.MinValue };
foreach (float value in values)
Console.WriteLine(\$"Abs({value}) = {Math.Abs(value)}");

// The example displays the following output:
//       Abs(3.402823E+38) = 3.402823E+38
//       Abs(1.6354E-11) = 1.6354E-11
//       Abs(15.09812) = 15.09812
//       Abs(0) = 0
//       Abs(-19.06971) = 19.06971
//       Abs(-1.5058E+18) = 1.5058E+18
//       Abs(-3.402823E+38) = 3.402823E+38
open System

let values =
[ Single.MaxValue; 16.354e-12f; 15.098123f; 0f
-19.069713f; -15.058e17f; Single.MinValue ]

for value in values do
// The 'abs' function may be used instead.
printfn \$"Abs({value}) = {Math.Abs value}"

// The example displays the following output:
//       Abs(3.402823E+38) = 3.402823E+38
//       Abs(1.6354E-11) = 1.6354E-11
//       Abs(15.09812) = 15.09812
//       Abs(0) = 0
//       Abs(-19.06971) = 19.06971
//       Abs(-1.5058E+18) = 1.5058E+18
//       Abs(-3.402823E+38) = 3.402823E+38
Module Example
Public Sub Main()
Dim values() As Single = { Single.MaxValue, 16.354e-12, 15.098123, 0, _
-19.069713, -15.058e17, Single.MinValue }
For Each value As Single In values
Console.WriteLine("Abs({0}) = {1}", value, Math.Abs(value))
Next
End Sub
End Module
' The example displays the following output:
'       Abs(3.402823E+38) = 3.402823E+38
'       Abs(1.6354E-11) = 1.6354E-11
'       Abs(15.09812) = 15.09812
'       Abs(0) = 0
'       Abs(-19.06971) = 19.06971
'       Abs(-1.5058E+18) = 1.5058E+18
'       Abs(-3.402823E+38) = 3.402823E+38

### Remarks

The absolute value of a Single is its numeric value without its sign. For example, the absolute value of both 1.2e-03 and -1.2e03 is 1.2e03.

If value is equal to NegativeInfinity or PositiveInfinity, the return value is PositiveInfinity. If value is equal to NaN, the return value is NaN.