Math.Abs 方法

定義

傳回指定數字的絕對值。Returns the absolute value of a specified number.

多載

Abs(Decimal)

傳回 Decimal 數字的絕對值。Returns the absolute value of a Decimal number.

Abs(Double)

傳回雙精確度浮點數的絕對值。Returns the absolute value of a double-precision floating-point number.

Abs(Int16)

傳回 16 位元帶正負號整數的絕對值。Returns the absolute value of a 16-bit signed integer.

Abs(Int32)

傳回 32 位元帶正負號整數的絕對值。Returns the absolute value of a 32-bit signed integer.

Abs(Int64)

傳回 64 位元帶正負號整數的絕對值。Returns the absolute value of a 64-bit signed integer.

Abs(SByte)

傳回 8 位元帶正負號整數的絕對值。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)

傳回 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

參數

value
Decimal

大於或等於 MinValue但小於或等於 MaxValue 的數字。A number that is greater than or equal to MinValue, but less than or equal to MaxValue.

傳回

十進位數字 x,其滿足下列條件 0 ≤ x ≤MaxValueA decimal number, x, such that 0 ≤ x ≤MaxValue.

範例

下列範例會使用Abs(Decimal)方法來取得Decimal值數目的絕對值。The following example uses the Abs(Decimal) method to get the absolute value of a number of Decimal values.

using System;

public class Example
{
   public static void Main()
   {
      decimal[] decimals = { Decimal.MaxValue, 12.45M, 0M, -19.69M, 
                             Decimal.MinValue };
      foreach (decimal value in decimals)
         Console.WriteLine("Abs({0}) = {1}", 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

備註

的絕對值Decimal是其在沒有正負號的數位值。The absolute value of a Decimal is its numeric value without its sign. 例如,1.2 和-1.2 的絕對值都是1.2。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

參數

value
Double

大於或等於 MinValue但小於或等於 MaxValue 的數字。A number that is greater than or equal to MinValue, but less than or equal to MaxValue.

傳回

雙精確度浮點數 x,其滿足下列條件 0 ≤ x ≤MaxValueA double-precision floating-point number, x, such that 0 ≤ x ≤MaxValue.

範例

下列範例會使用Abs(Double)方法來取得Double值數目的絕對值。The following example uses the Abs(Double) method to get the absolute value of a number of Double values.

using System;

public class Example
{
   public static void Main()
   {
      double[] doubles = { Double.MaxValue, 16.354e-17, 15.098123, 0, 
                           -19.069713, -15.058e18, Double.MinValue };
      foreach (double value in doubles)
         Console.WriteLine("Abs({0}) = {1}", 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

備註

的絕對值Double是其在沒有正負號的數位值。The absolute value of a Double is its numeric value without its sign. 例如,1.2 e03 和-1.2 e03 的絕對值為 1.2 e03。For example, the absolute value of both 1.2e03 and -1.2e03 is 1.2e03.

如果value PositiveInfinity等於或,PositiveInfinity則傳回值為。 NegativeInfinityIf value is equal to NegativeInfinity or PositiveInfinity, the return value is PositiveInfinity. 如果value NaN等於,則傳回值為。NaNIf value is equal to NaN, the return value is NaN.

Abs(Int16)

傳回 16 位元帶正負號整數的絕對值。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

參數

value
Int16

大於 MinValue但小於或等於 MaxValue 的數字。A number that is greater than MinValue, but less than or equal to MaxValue.

傳回

16 位元帶正負號整數 x,其滿足下列條件 0 ≤ x ≤MaxValueA 16-bit signed integer, x, such that 0 ≤ x ≤MaxValue.

例外狀況

value等於 MinValuevalue equals MinValue.

範例

下列範例會使用Abs(Int16)方法來取得Int16值數目的絕對值。The following example uses the Abs(Int16) method to get the absolute value of a number of Int16 values.

using System;

public class Example
{
   public static void Main()
   {
      short[] values = { Int16.MaxValue, 10328, 0, -1476, Int16.MinValue };
      foreach (short 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(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.

備註

的絕對值Int16是其在沒有正負號的數位值。The absolute value of an Int16 is its numeric value without its sign. 例如,123和-123 的絕對值都是123。For example, the absolute value of both 123 and -123 is 123.

Abs(Int32)

傳回 32 位元帶正負號整數的絕對值。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

參數

value
Int32

大於 MinValue但小於或等於 MaxValue 的數字。A number that is greater than MinValue, but less than or equal to MaxValue.

傳回

32 位元帶正負號整數 x,其滿足下列條件 0 ≤ x ≤MaxValueA 32-bit signed integer, x, such that 0 ≤ x ≤MaxValue.

例外狀況

value等於 MinValuevalue equals MinValue.

範例

下列範例會使用Abs(Int32)方法來取得Int32值數目的絕對值。The following example uses the Abs(Int32) method to get the absolute value of a number of Int32 values.

using System;

public class Example
{
   public static void Main()
   {
      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.
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.

備註

的絕對值Int32是其在沒有正負號的數位值。The absolute value of an Int32 is its numeric value without its sign. 例如,123和-123 的絕對值都是123。For example, the absolute value of both 123 and -123 is 123.

Abs(Int64)

傳回 64 位元帶正負號整數的絕對值。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

參數

value
Int64

大於 MinValue但小於或等於 MaxValue 的數字。A number that is greater than MinValue, but less than or equal to MaxValue.

傳回

64 位元帶正負號整數 x,其滿足下列條件 0 ≤ x ≤MaxValueA 64-bit signed integer, x, such that 0 ≤ x ≤MaxValue.

例外狀況

value等於 MinValuevalue equals MinValue.

範例

下列範例會使用Abs(Int64)方法來取得Int64值數目的絕對值。The following example uses the Abs(Int64) method to get the absolute value of a number of Int64 values.

using System;

public class Example
{
   public static void Main()
   {
      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.
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.

備註

的絕對值Int64是其在沒有正負號的數位值。The absolute value of an Int64 is its numeric value without its sign. 例如,123和-123 的絕對值都是123。For example, the absolute value of both 123 and -123 is 123.

Abs(SByte)

重要

此 API 不符合 CLS 規範。

傳回 8 位元帶正負號整數的絕對值。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);
static member Abs : sbyte -> sbyte
Public Shared Function Abs (value As SByte) As SByte

參數

value
SByte

大於 MinValue但小於或等於 MaxValue 的數字。A number that is greater than MinValue, but less than or equal to MaxValue.

傳回

8 位元帶正負號整數 x,其滿足下列條件 0 ≤ x ≤MaxValueAn 8-bit signed integer, x, such that 0 ≤ x ≤MaxValue.

屬性

例外狀況

value等於 MinValuevalue equals MinValue.

範例

下列範例會使用Abs(SByte)方法來取得SByte值數目的絕對值。The following example uses the Abs(SByte) method to get the absolute value of a number of SByte values.

using System;

public class Example
{
    public static void Main()
    {
      sbyte[] values = { SByte.MaxValue, 98, 0, -32, SByte.MinValue };
      foreach (sbyte 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(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.

備註

帶正負號之位元組的絕對值是其數值,但不含符號。The absolute value of a signed byte is its numeric value without its sign. 例如,12和-12 兩者的絕對值都是12。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

參數

value
Single

大於或等於 MinValue但小於或等於 MaxValue 的數字。A number that is greater than or equal to MinValue, but less than or equal to MaxValue.

傳回

單精確度浮點數 x,其滿足下列條件 0 ≤ x ≤MaxValueA single-precision floating-point number, x, such that 0 ≤ x ≤MaxValue.

範例

下列範例會使用Abs(Single)方法來取得Single值數目的絕對值。The following example uses the Abs(Single) method to get the absolute value of a number of Single values.

using System;

public class Example
{
   public static void Main()
   {
      float[] values= { Single.MaxValue, 16.354e-12F, 15.098123F, 0F, 
                        -19.069713F, -15.058e17F, Single.MinValue };
      foreach (float value in values)
         Console.WriteLine("Abs({0}) = {1}", 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

備註

的絕對值Single是其在沒有正負號的數位值。The absolute value of a Single is its numeric value without its sign. 例如,1.2 e-03 和-1.2 e03 的絕對值為 1.2 e03。For example, the absolute value of both 1.2e-03 and -1.2e03 is 1.2e03.

如果value PositiveInfinity等於或,PositiveInfinity則傳回值為。 NegativeInfinityIf value is equal to NegativeInfinity or PositiveInfinity, the return value is PositiveInfinity. 如果value NaN等於,則傳回值為。NaNIf value is equal to NaN, the return value is NaN.

適用於