Math.Ceiling Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Retorna o menor valor inteiro maior ou igual ao número especificado.

Sobrecargas

Ceiling(Decimal)	Retorna o menor valor integral maior ou igual ao número decimal especificado.
Ceiling(Double)	Retorna o menor valor integral maior ou igual ao número de ponto flutuante de precisão dupla especificado.

Comentários

O comportamento deste método segue o padrão IEEE 754, seção 4. Este tipo de arredondamento às vezes é chamado de arredondamento para positivo infinito.

Ceiling(Decimal)

Origem:

Math.cs

Retorna o menor valor integral maior ou igual ao número decimal especificado.

C#

public static decimal Ceiling(decimal d);

Parâmetros

d

Decimal

Um número decimal.

Retornos

Decimal

O menor valor integral maior ou igual a d. Observe que esse método retorna um Decimal em vez de um tipo integral.

Exemplos

O exemplo a seguir ilustra o Math.Ceiling(Decimal) método e o contrasta com o Floor(Decimal) método .

C#

decimal[] values = {7.03m, 7.64m, 0.12m, -0.12m, -7.1m, -7.6m};
Console.WriteLine("  Value          Ceiling          Floor\n");
foreach (decimal value in values)
   Console.WriteLine("{0,7} {1,16} {2,14}",
                     value, Math.Ceiling(value), Math.Floor(value));
// The example displays the following output to the console:
//         Value          Ceiling          Floor
//
//          7.03                8              7
//          7.64                8              7
//          0.12                1              0
//         -0.12                0             -1
//          -7.1               -7             -8
//          -7.6               -7             -8

Comentários

O comportamento deste método segue o padrão IEEE 754, seção 4. Este tipo de arredondamento às vezes é chamado de arredondamento para positivo infinito. Em outras palavras, se d for positivo, a presença de qualquer componente fracionário fará d com que seja arredondada para o próximo inteiro mais alto. Se d for negativo, a operação de arredondamento fará com que qualquer componente fracionário de d seja descartado. A operação desse método difere do método , que dá suporte ao Floor(Decimal) arredondamento em direção ao infinito negativo.

Confira também

• Round
• Floor(Decimal)

Ceiling(Double)

Origem:

Math.cs

Retorna o menor valor integral maior ou igual ao número de ponto flutuante de precisão dupla especificado.

C#

public static double Ceiling(double a);

Parâmetros

a

Double

Um número de ponto flutuante de precisão dupla.

Retornos

Double

O menor valor integral maior ou igual a a. Se a for igual a NaN, NegativeInfinity ou PositiveInfinity, esse valor será retornado. Observe que esse método retorna um Double em vez de um tipo integral.

Exemplos

O exemplo a seguir ilustra o Math.Ceiling(Double) método e o contrasta com o Floor(Double) método .

C#

double[] values = {7.03, 7.64, 0.12, -0.12, -7.1, -7.6};
Console.WriteLine("  Value          Ceiling          Floor\n");
foreach (double value in values)
   Console.WriteLine("{0,7} {1,16} {2,14}",
                     value, Math.Ceiling(value), Math.Floor(value));
// The example displays the following output to the console:
//         Value          Ceiling          Floor
//
//          7.03                8              7
//          7.64                8              7
//          0.12                1              0
//         -0.12                0             -1
//          -7.1               -7             -8
//          -7.6               -7             -8

Comentários

O comportamento deste método segue o padrão IEEE 754, seção 4. Este tipo de arredondamento às vezes é chamado de arredondamento para positivo infinito. Em outras palavras, se a for positivo, a presença de qualquer componente fracionário fará a com que seja arredondada para o próximo inteiro mais alto. Se a for negativo, a operação de arredondamento fará com que qualquer componente fracionário de a seja descartado. A operação desse método difere do método , que dá suporte ao Floor(Double) arredondamento em direção ao infinito negativo.

A partir do Visual Basic 15.8, o desempenho da conversão double-to-integer será otimizado se você passar o valor retornado pelo Ceiling método para qualquer uma das funções de conversão integral ou se o valor Double retornado por Ceiling for convertido automaticamente em um inteiro com Option Strict definido como Desativado. Essa otimização permite que o código seja executado mais rapidamente – até duas vezes mais rápido para o código que faz um grande número de conversões para tipos de inteiro. O exemplo a seguir ilustra essas conversões otimizadas:

VB

Dim d1 As Double = 1043.75133
Dim i1 As Integer = CInt(Math.Ceiling(d1))        ' Result: 1044

Dim d2 As Double = 7968.4136
Dim i2 As Integer = CInt(Math.Ceiling(d2))        ' Result: 7969

Confira também

• Round
• Floor(Double)