Math.Ceiling Метод

Определение

Пространство имен:
System
Сборки:
mscorlib.dll, System.Runtime.Extensions.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.Runtime.Extensions.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Возвращает наименьшее целочисленное значение, большее или равное указанному числу.

Перегрузки

Имя Описание
Ceiling(Decimal)

Возвращает наименьшее целочисленное значение, большее или равное указанному десятичному числу.
Ceiling(Double)

Возвращает наименьшее целочисленное значение, большее или равное указанному числу с плавающей запятой двойной точности.

Комментарии

Поведение этого метода следует стандарту IEEE 754, раздел 4. Этот вид округления иногда называется округлением в сторону положительной бесконечности.

Ceiling(Decimal)

Исходный код:
Math.cs
Исходный код:
Math.cs
Исходный код:
Math.cs
Исходный код:
Math.cs
Исходный код:
Math.cs

Возвращает наименьшее целочисленное значение, большее или равное указанному десятичному числу.

public:
 static System::Decimal Ceiling(System::Decimal d);
public static decimal Ceiling(decimal d);
static member Ceiling : decimal -> decimal
Public Shared Function Ceiling (d As Decimal) As Decimal

Параметры

d
Decimal

Десятичное число.

Возвращаемое значение

Decimal

Наименьшее целочисленное значение, которое больше или равно d. Обратите внимание, что этот метод возвращает Decimal вместо целочисленного типа.

Примеры

В следующем примере показан Math.Ceiling(Decimal) метод и контрастирует его с методом Floor(Decimal) .

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

// The ceil and floor functions may be used instead. 
let values = 
    [ 7.03m; 7.64m; 0.12m; -0.12m; -7.1m; -7.6m ]
printfn "  Value          Ceiling          Floor\n"
for value in values do
    printfn $"{value,7} {Math.Ceiling value,16} {Math.Floor value,14}"
// 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

Dim values() As Decimal = {7.03d, 7.64d, 0.12d, -0.12d, -7.1d, -7.6d}
Console.WriteLine("  Value          Ceiling          Floor")
Console.WriteLine()
For Each value As Decimal In values
   Console.WriteLine("{0,7} {1,16} {2,14}", _
                     value, Math.Ceiling(value), Math.Floor(value))
Next   
' 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

Комментарии

Поведение этого метода следует стандарту IEEE 754, раздел 4. Этот вид округления иногда называется округлением в сторону положительной бесконечности. Другими словами, если d это положительно, наличие любого дробного компонента приводит d к округление до следующего самого высокого целого числа. Если d это отрицательно, операция округления приводит к отмене любого дробного компонента d . Операция этого метода отличается от Floor(Decimal) метода, который поддерживает округление к отрицательной бесконечности.

См. также раздел

Применяется к

Ceiling(Double)

Исходный код:
Math.cs
Исходный код:
Math.cs
Исходный код:
Math.cs
Исходный код:
Math.cs
Исходный код:
Math.cs

Возвращает наименьшее целочисленное значение, большее или равное указанному числу с плавающей запятой двойной точности.

public:
 static double Ceiling(double a);
public static double Ceiling(double a);
static member Ceiling : double -> double
Public Shared Function Ceiling (a As Double) As Double

Параметры

a
Double

Число с плавающей запятой двойной точности.

Возвращаемое значение

Double

Наименьшее целочисленное значение, которое больше или равно a. Если a значение равно NaN, NegativeInfinityили PositiveInfinityвозвращается это значение. Обратите внимание, что этот метод возвращает Double вместо целочисленного типа.

Примеры

В следующем примере показан Math.Ceiling(Double) метод и контрастирует его с методом Floor(Double) .

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

// The ceil and floor functions may be used instead.
let values = 
    [ 7.03; 7.64; 0.12; -0.12; -7.1; -7.6 ]
printfn "  Value          Ceiling          Floor\n"
for value in values do
    printfn $"{value,7} {Math.Ceiling value,16} {Math.Floor value,14}"
// 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

Dim values() As Double = {7.03, 7.64, 0.12, -0.12, -7.1, -7.6}
Console.WriteLine("  Value          Ceiling          Floor")
Console.WriteLine()
For Each value As Double In values
   Console.WriteLine("{0,7} {1,16} {2,14}", _
                     value, Math.Ceiling(value), Math.Floor(value))
Next   
' 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

Комментарии

Поведение этого метода следует стандарту IEEE 754, раздел 4. Этот вид округления иногда называется округлением в сторону положительной бесконечности. Другими словами, если a это положительно, наличие любого дробного компонента приводит a к округление до следующего самого высокого целого числа. Если a это отрицательно, операция округления приводит к отмене любого дробного компонента a . Операция этого метода отличается от Floor(Double) метода, который поддерживает округление к отрицательной бесконечности.

Начиная с Visual Basic 15.8 производительность преобразования double-to-integer оптимизирована при передаче значения, возвращаемого методом Ceiling любому из функций преобразования integral преобразования, или значение Double, возвращаемое Ceiling, автоматически преобразуется в целое число с Option Strict значение Off. Эта оптимизация позволяет выполнять код быстрее — до двух раз быстрее для кода, выполняющего большое количество преобразований в целые типы. В следующем примере показаны такие оптимизированные преобразования:

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

См. также раздел

Применяется к