Partilhar via


Math.Abs Método

Definição

Retorna o valor absoluto de um número especificado.

Sobrecargas

Abs(Decimal)

Retorna o valor absoluto de um número Decimal.

Abs(Double)

Retorna o valor absoluto de um número de ponto flutuante de precisão dupla.

Abs(Int16)

Retorna o valor absoluto de um inteiro com sinal de 16 bits.

Abs(Int32)

Retorna o valor absoluto de um inteiro com sinal de 32 bits.

Abs(Int64)

Retorna o valor absoluto de um inteiro com sinal de 64 bits.

Abs(IntPtr)

Retorna o valor absoluto de um inteiro com sinal nativo.

Abs(SByte)

Retorna o valor absoluto de um inteiro com sinal de 8 bits.

Abs(Single)

Retorna o valor absoluto de um número de ponto flutuante de precisão simples.

Abs(Decimal)

Origem:
Math.cs
Origem:
Math.cs
Origem:
Math.cs

Retorna o valor absoluto de um número Decimal.

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

Parâmetros

value
Decimal

Um número maior ou igual a Decimal.MinValue, mas menor ou igual a Decimal.MaxValue.

Retornos

Um número decimal, x, de modo que 0 ≤ x ≤ Decimal.MaxValue.

Exemplos

O exemplo a seguir usa o Abs(Decimal) método para obter o valor absoluto de vários Decimal valores.

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

Comentários

O valor absoluto de um Decimal é seu valor numérico sem seu sinal. Por exemplo, o valor absoluto de 1,2 e -1,2 é 1,2.

Aplica-se a

Abs(Double)

Origem:
Math.cs
Origem:
Math.cs
Origem:
Math.cs

Retorna o valor absoluto de um número de ponto flutuante de precisão dupla.

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

Parâmetros

value
Double

Um número maior ou igual a Double.MinValue, mas menor ou igual a Double.MaxValue.

Retornos

Um número de ponto flutuante de precisão dupla, x, de modo que 0 ≤ x ≤ Double.MaxValue.

Exemplos

O exemplo a seguir usa o Abs(Double) método para obter o valor absoluto de vários Double valores.

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

Comentários

O valor absoluto de um Double é seu valor numérico sem seu sinal. Por exemplo, o valor absoluto de 1,2e03 e -1,2e03 é 1,2e03.

Se value for igual a NegativeInfinity ou PositiveInfinity, o valor retornado será PositiveInfinity. Se value for igual a NaN, o valor retornado será NaN.

Aplica-se a

Abs(Int16)

Origem:
Math.cs
Origem:
Math.cs
Origem:
Math.cs

Retorna o valor absoluto de um inteiro com sinal de 16 bits.

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

Parâmetros

value
Int16

Um número maior que Int16.MinValue, mas menor ou igual a Int16.MaxValue.

Retornos

Um inteiro com sinal de 16 bits, x, de modo que 0 ≤ x ≤ Int16.MaxValue.

Exceções

value é igual a Int16.MinValue.

Exemplos

O exemplo a seguir usa o Abs(Int16) método para obter o valor absoluto de vários Int16 valores.

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.

Comentários

O valor absoluto de um Int16 é seu valor numérico sem seu sinal. Por exemplo, o valor absoluto de 123 e -123 é 123.

Aplica-se a

Abs(Int32)

Origem:
Math.cs
Origem:
Math.cs
Origem:
Math.cs

Retorna o valor absoluto de um inteiro com sinal de 32 bits.

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

Parâmetros

value
Int32

Um número maior que Int32.MinValue, mas menor ou igual a Int32.MaxValue.

Retornos

Um inteiro com sinal de 32 bits, x, de modo que 0 ≤ x ≤ Int32.MaxValue.

Exceções

value é igual a Int32.MinValue.

Exemplos

O exemplo a seguir usa o Abs(Int32) método para obter o valor absoluto de vários Int32 valores.

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.

Comentários

O valor absoluto de um Int32 é seu valor numérico sem seu sinal. Por exemplo, o valor absoluto de 123 e -123 é 123.

Aplica-se a

Abs(Int64)

Origem:
Math.cs
Origem:
Math.cs
Origem:
Math.cs

Retorna o valor absoluto de um inteiro com sinal de 64 bits.

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

Parâmetros

value
Int64

Um número maior que Int64.MinValue, mas menor ou igual a Int64.MaxValue.

Retornos

Um inteiro com sinal de 64 bits, x, de modo que 0 ≤ x ≤ Int64.MaxValue.

Exceções

value é igual a Int64.MinValue.

Exemplos

O exemplo a seguir usa o Abs(Int64) método para obter o valor absoluto de vários Int64 valores.

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.

Comentários

O valor absoluto de um Int64 é seu valor numérico sem seu sinal. Por exemplo, o valor absoluto de 123 e -123 é 123.

Aplica-se a

Abs(IntPtr)

Origem:
Math.cs
Origem:
Math.cs
Origem:
Math.cs

Retorna o valor absoluto de um inteiro com sinal nativo.

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

Parâmetros

value
IntPtr

nint

nativeint

Um número maior que MinValue, mas menor ou igual a MaxValue.

Retornos

IntPtr

nint

nativeint

Um inteiro com sinal nativo, x, de modo que 0 ≤ x ≤ MaxValue.

Aplica-se a

Abs(SByte)

Origem:
Math.cs
Origem:
Math.cs
Origem:
Math.cs

Importante

Esta API não está em conformidade com CLS.

Retorna o valor absoluto de um inteiro com sinal de 8 bits.

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

Parâmetros

value
SByte

Um número maior que SByte.MinValue, mas menor ou igual a SByte.MaxValue.

Retornos

Um inteiro com sinal de 8 bits, x, de modo que 0 ≤ x ≤ SByte.MaxValue.

Atributos

Exceções

value é igual a SByte.MinValue.

Exemplos

O exemplo a seguir usa o Abs(SByte) método para obter o valor absoluto de vários SByte valores.

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.

Comentários

O valor absoluto de um byte assinado é seu valor numérico sem seu sinal. Por exemplo, o valor absoluto de 12 e -12 é 12.

Aplica-se a

Abs(Single)

Origem:
Math.cs
Origem:
Math.cs
Origem:
Math.cs

Retorna o valor absoluto de um número de ponto flutuante de precisão simples.

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

Parâmetros

value
Single

Um número maior ou igual a Single.MinValue, mas menor ou igual a Single.MaxValue.

Retornos

Um número de ponto flutuante de precisão única, x, de modo que 0 ≤ x ≤ Single.MaxValue.

Exemplos

O exemplo a seguir usa o Abs(Single) método para obter o valor absoluto de vários Single valores.

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

Comentários

O valor absoluto de um Single é seu valor numérico sem seu sinal. Por exemplo, o valor absoluto de 1.2e-03 e -1.2e03 é 1.2e03.

Se value for igual a NegativeInfinity ou PositiveInfinity, o valor retornado será PositiveInfinity. Se value for igual a NaN, o valor retornado será NaN.

Aplica-se a