Math.Ceiling Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Vrátí nejmenší celočíselnou hodnotu větší nebo rovno zadanému číslu.

Přetížení

Name	Description
Ceiling(Decimal)	Vrátí nejmenší celočíselnou hodnotu, která je větší nebo rovna zadanému desetinné číslu.
Ceiling(Double)	Vrátí nejmenší celočíselnou hodnotu, která je větší nebo rovna zadanému číslu s plovoucí desetinnou čárkou s dvojitou přesností.

Poznámky

Chování této metody se řídí standardem IEEE 754, oddílem 4. Tento druh zaokrouhlování se někdy nazývá zaokrouhlování směrem k kladnému nekonečnu.

Ceiling(Decimal)

Zdroj:

Math.cs

Vrátí nejmenší celočíselnou hodnotu, která je větší nebo rovna zadanému desetinné číslu.

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

Parametry

d

Decimal

Desetinné číslo.

Návraty

Decimal

Nejmenší celočíselnou hodnotu, která je větší nebo rovna d. Všimněte si, že tato metoda vrací Decimal místo celočíselného typu.

Příklady

Následující příklad znázorňuje metodu Math.Ceiling(Decimal) a kontrastuje s metodou 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

Poznámky

Chování této metody se řídí standardem IEEE 754, oddílem 4. Tento druh zaokrouhlování se někdy nazývá zaokrouhlování směrem k kladnému nekonečnu. Jinými slovy, pokud d je pozitivní, přítomnost jakékoli zlomkové komponenty způsobí d zaokrouhlení na další nejvyšší celé číslo. Pokud d je záporná, operace zaokrouhlení způsobí, že se zahodí jakákoli část d zlomku. Operace této metody se liší od Floor(Decimal) metody, která podporuje zaokrouhlování směrem k zápornému nekonečnu.

Viz také

• Round
• Floor(Decimal)

Ceiling(Double)

Zdroj:

Math.cs

Vrátí nejmenší celočíselnou hodnotu, která je větší nebo rovna zadanému číslu s plovoucí desetinnou čárkou s dvojitou přesností.

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

Parametry

a

Double

Číslo s plovoucí desetinnou čárkou s dvojitou přesností.

Návraty

Double

Nejmenší celočíselnou hodnotu, která je větší nebo rovna a. Je-li a rovna NaN, NegativeInfinitynebo PositiveInfinity, tato hodnota je vrácena. Všimněte si, že tato metoda vrací Double místo celočíselného typu.

Příklady

Následující příklad znázorňuje metodu Math.Ceiling(Double) a kontrastuje s metodou 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

Poznámky

Chování této metody se řídí standardem IEEE 754, oddílem 4. Tento druh zaokrouhlování se někdy nazývá zaokrouhlování směrem k kladnému nekonečnu. Jinými slovy, pokud a je pozitivní, přítomnost jakékoli zlomkové komponenty způsobí a zaokrouhlení na další nejvyšší celé číslo. Pokud a je záporná, operace zaokrouhlení způsobí, že se zahodí jakákoli část a zlomku. Operace této metody se liší od Floor(Double) metody, která podporuje zaokrouhlování směrem k zápornému nekonečnu.

Počínaje Visual Basic 15.8 je výkon převodu typu Double-to-integer optimalizovaný, pokud předáte hodnotu vrácenou metodou Ceiling do některé z funkcí převodu integral conversion, nebo pokud je hodnota double vrácená Ceiling automaticky převedena na celé číslo s Option Strict nastavenou na hodnotu Vypnuto. Tato optimalizace umožňuje, aby kód běžel rychleji – až dvakrát rychleji pro kód, který provede velký počet převodů na celočíselné typy. Následující příklad znázorňuje takové optimalizované převody:

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

Viz také

• Round
• Floor(Double)