• Article

Math.Abs Method (Int32)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Updated: September 2010

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

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

Syntax

'Declaration
Public Shared Function Abs ( _
    value As Integer _
) As Integer

public static int Abs(
    int value
)

Parameters

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 Math.Abs(Int32) method to get the absolute values of several Int32 values.

Dim values() As Integer = {Int32.MaxValue, 16921, 0, -804128, Int32.MinValue}
For Each value As Integer In values
   Try
      outputBlock.Text += String.Format("Abs({0}) = {1}", value, Math.Abs(value)) & vbCrLf
   Catch e As OverflowException
      outputBlock.Text += String.Format("Unable to calculate the absolute value of {0}.", _
                        value) & vbCrLf
   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.

int[] values = { Int32.MaxValue, 16921, 0, -804128, Int32.MinValue };
foreach (int value in values)
{
   try
   {
      outputBlock.Text += String.Format("Abs({0}) = {1}", value, Math.Abs(value)) + "\n";
   }
   catch (OverflowException)
   {
      outputBlock.Text += String.Format("Unable to calculate the absolute value of {0}.",
                        value) + "\n";
   }
}
// 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

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Change History

Date

History

Reason

September 2010

Added a definition of absolute value.

Customer feedback.