Math.Abs Method (Int32) (System)

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

Updated: July 2010

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

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

Parameters

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

Return Value

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

value equals Int32.MinValue.

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.

Examples

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

Visual Basic

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

int[] values = { Int32.MaxValue, 16921, 0, -804128, Int32.MinValue };
foreach (int 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(2147483647) = 2147483647
//       Abs(16921) = 16921
//       Abs(0) = 0
//       Abs(-804128) = 804128
//       Unable to calculate the absolute value of -2147483648.
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.