Math.Abs Metoda

Definicja

Zwraca wartość bezwzględną podanej liczby.Returns the absolute value of a specified number.

Przeciążenia

Abs(Decimal)

Zwraca wartość bezwzględną liczby Decimal.Returns the absolute value of a Decimal number.

Abs(Double)

Zwraca wartość bezwzględną liczby zmiennoprzecinkowej o podwójnej precyzji.Returns the absolute value of a double-precision floating-point number.

Abs(Int16)

Zwraca wartość bezwzględną 16-bitową liczbę całkowitą ze znakiem.Returns the absolute value of a 16-bit signed integer.

Abs(Int32)

Zwraca wartość bezwzględną 32-bitową liczbę całkowitą ze znakiem.Returns the absolute value of a 32-bit signed integer.

Abs(Int64)

Zwraca wartość bezwzględną 64-bitową liczbę całkowitą ze znakiem.Returns the absolute value of a 64-bit signed integer.

Abs(SByte)

Zwraca wartość bezwzględną 8-bitową liczbę całkowitą ze znakiem.Returns the absolute value of an 8-bit signed integer.

Abs(Single)

Zwraca wartość bezwzględną liczby zmiennoprzecinkowej o pojedynczej precyzji.Returns the absolute value of a single-precision floating-point number.

Abs(Decimal)

Zwraca wartość bezwzględną liczby 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

Parametry

value
Decimal

Liczba, która jest większa lub równa MinValue, ale mniejsza lub równa MaxValue.A number that is greater than or equal to MinValue, but less than or equal to MaxValue.

Zwraca

Liczba dziesiętna, x, taka jak 0 ≤ x ≤MaxValue.A decimal number, x, such that 0 ≤ x ≤MaxValue.

Przykłady

W poniższym przykładzie zastosowano metodę Abs(Decimal), aby uzyskać wartość bezwzględną liczby Decimal wartości.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
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

Uwagi

Wartość bezwzględna Decimal jest wartością numeryczną bez znaku.The absolute value of a Decimal is its numeric value without its sign. Na przykład wartość bezwzględna obu 1,2 i-1,2 to 1,2.For example, the absolute value of both 1.2 and -1.2 is 1.2.

Abs(Double)

Zwraca wartość bezwzględną liczby zmiennoprzecinkowej o podwójnej precyzji.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

Parametry

value
Double

Liczba, która jest większa lub równa MinValue, ale mniejsza lub równa MaxValue.A number that is greater than or equal to MinValue, but less than or equal to MaxValue.

Zwraca

Liczba zmiennoprzecinkowa podwójnej precyzji, x, taka jak 0 ≤ x ≤MaxValue.A double-precision floating-point number, x, such that 0 ≤ x ≤MaxValue.

Przykłady

W poniższym przykładzie zastosowano metodę Abs(Double), aby uzyskać wartość bezwzględną liczby Double wartości.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
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

Uwagi

Wartość bezwzględna Double jest wartością numeryczną bez znaku.The absolute value of a Double is its numeric value without its sign. Na przykład wartość bezwzględna obu 1,2 E03 i-1,2 E03 to 1,2 E03.For example, the absolute value of both 1.2e03 and -1.2e03 is 1.2e03.

Jeśli value jest równe NegativeInfinity lub PositiveInfinity, wartość zwracana jest PositiveInfinity.If value is equal to NegativeInfinity or PositiveInfinity, the return value is PositiveInfinity. Jeśli value jest równa NaN, wartość zwracana jest NaN.If value is equal to NaN, the return value is NaN.

Abs(Int16)

Zwraca wartość bezwzględną 16-bitową liczbę całkowitą ze znakiem.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

Parametry

value
Int16

Liczba, która jest większa niż MinValue, ale mniejsza lub równa MaxValue.A number that is greater than MinValue, but less than or equal to MaxValue.

Zwraca

16-bitowa liczba całkowita ze znakiem x, taka jak 0 ≤ x ≤MaxValue.A 16-bit signed integer, x, such that 0 ≤ x ≤MaxValue.

Wyjątki

value równe MinValue.value equals MinValue.

Przykłady

W poniższym przykładzie zastosowano metodę Abs(Int16), aby uzyskać wartość bezwzględną liczby Int16 wartości.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.
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.

Uwagi

Wartość bezwzględna Int16 jest wartością numeryczną bez znaku.The absolute value of an Int16 is its numeric value without its sign. Na przykład wartość bezwzględna obu 123 i-123 to 123.For example, the absolute value of both 123 and -123 is 123.

Abs(Int32)

Zwraca wartość bezwzględną 32-bitową liczbę całkowitą ze znakiem.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

Parametry

value
Int32

Liczba, która jest większa niż MinValue, ale mniejsza lub równa MaxValue.A number that is greater than MinValue, but less than or equal to MaxValue.

Zwraca

32-bitowa liczba całkowita ze znakiem x, taka jak 0 ≤ x ≤MaxValue.A 32-bit signed integer, x, such that 0 ≤ x ≤MaxValue.

Wyjątki

value równe MinValue.value equals MinValue.

Przykłady

W poniższym przykładzie zastosowano metodę Abs(Int32), aby uzyskać wartość bezwzględną liczby Int32 wartości.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.
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.

Uwagi

Wartość bezwzględna Int32 jest wartością numeryczną bez znaku.The absolute value of an Int32 is its numeric value without its sign. Na przykład wartość bezwzględna obu 123 i-123 to 123.For example, the absolute value of both 123 and -123 is 123.

Abs(Int64)

Zwraca wartość bezwzględną 64-bitową liczbę całkowitą ze znakiem.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

Parametry

value
Int64

Liczba, która jest większa niż MinValue, ale mniejsza lub równa MaxValue.A number that is greater than MinValue, but less than or equal to MaxValue.

Zwraca

64-bitowa liczba całkowita ze znakiem x, taka jak 0 ≤ x ≤MaxValue.A 64-bit signed integer, x, such that 0 ≤ x ≤MaxValue.

Wyjątki

value równe MinValue.value equals MinValue.

Przykłady

W poniższym przykładzie zastosowano metodę Abs(Int64), aby uzyskać wartość bezwzględną liczby Int64 wartości.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.
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.

Uwagi

Wartość bezwzględna Int64 jest wartością numeryczną bez znaku.The absolute value of an Int64 is its numeric value without its sign. Na przykład wartość bezwzględna obu 123 i-123 to 123.For example, the absolute value of both 123 and -123 is 123.

Abs(SByte)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zwraca wartość bezwzględną 8-bitową liczbę całkowitą ze znakiem.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

Parametry

value
SByte

Liczba, która jest większa niż MinValue, ale mniejsza lub równa MaxValue.A number that is greater than MinValue, but less than or equal to MaxValue.

Zwraca

8-bitowa liczba całkowita ze znakiem x, taka jak 0 ≤ x ≤MaxValue.An 8-bit signed integer, x, such that 0 ≤ x ≤MaxValue.

Atrybuty

Wyjątki

value równe MinValue.value equals MinValue.

Przykłady

W poniższym przykładzie zastosowano metodę Abs(SByte), aby uzyskać wartość bezwzględną liczby SByte wartości.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.
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.

Uwagi

Bezwzględna wartość bajtu ze znakiem jest wartością numeryczną bez znaku.The absolute value of a signed byte is its numeric value without its sign. Na przykład wartość bezwzględna równa 12 i-12 to 12.For example, the absolute value of both 12 and -12 is 12.

Abs(Single)

Zwraca wartość bezwzględną liczby zmiennoprzecinkowej o pojedynczej precyzji.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

Parametry

value
Single

Liczba, która jest większa lub równa MinValue, ale mniejsza lub równa MaxValue.A number that is greater than or equal to MinValue, but less than or equal to MaxValue.

Zwraca

Liczba zmiennoprzecinkowa o pojedynczej precyzji, x, taka jak 0 ≤ x ≤MaxValue.A single-precision floating-point number, x, such that 0 ≤ x ≤MaxValue.

Przykłady

W poniższym przykładzie zastosowano metodę Abs(Single), aby uzyskać wartość bezwzględną liczby Single wartości.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
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

Uwagi

Wartość bezwzględna Single jest wartością numeryczną bez znaku.The absolute value of a Single is its numeric value without its sign. Na przykład absolutna wartość obu 1,2 e-03 i-1,2 E03 to 1,2 E03.For example, the absolute value of both 1.2e-03 and -1.2e03 is 1.2e03.

Jeśli value jest równe NegativeInfinity lub PositiveInfinity, wartość zwracana jest PositiveInfinity.If value is equal to NegativeInfinity or PositiveInfinity, the return value is PositiveInfinity. Jeśli value jest równa NaN, wartość zwracana jest NaN.If value is equal to NaN, the return value is NaN.

Dotyczy