Math.Ceiling Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

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

Přetížení

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

Poznámky

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

Ceiling(Decimal)

Source:

Math.cs

Vrátí nejmenší celočíselnou hodnotu, která je větší než nebo rovna zadanému desetinném čí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číselná hodnota, 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 ji 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, část 4. Tento druh zaokrouhlování se někdy nazývá zaokrouhlení směrem ke kladnému nekonečnu. Jinými slovy, pokud d je hodnota kladná, přítomnost jakékoli zlomkové komponenty způsobí d zaokrouhlení na další nejvyšší celé číslo. Pokud d je hodnota záporná, operace zaokrouhlování způsobí, že se zahodí všechny zlomkové součásti d . Operace této metody se liší od metody, která podporuje zaokrouhlování směrem k zápornému Floor(Decimal) nekonečnu.

Viz také

• Round
• Floor(Decimal)

Ceiling(Double)

Source:

Math.cs

Vrátí nejmenší celočíselnou hodnotu, která je větší nebo rovna zadanému číslu s plovoucí desetinou čá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 dvojité přesnosti s plovoucí desetinnou čárkou.

Návraty

Double

Nejmenší celočíselná hodnota, která je větší nebo rovna a. Pokud a je hodnota rovna hodnotě NaN, NegativeInfinitynebo PositiveInfinity, vrátí se tato hodnota. 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 ji 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, část 4. Tento druh zaokrouhlování se někdy nazývá zaokrouhlení směrem ke kladnému nekonečnu. Jinými slovy, pokud a je hodnota kladná, přítomnost jakékoli zlomkové komponenty způsobí a zaokrouhlení na další nejvyšší celé číslo. Pokud a je hodnota záporná, operace zaokrouhlování způsobí, že se zahodí všechny zlomkové součásti a . Operace této metody se liší od metody, která podporuje zaokrouhlování směrem k zápornému Floor(Double) nekonečnu.

Počínaje Visual Basic 15.8 výkon převodu double-integer je optimalizováno, pokud hodnotu vrácenou metodou Ceiling předáte některé z integrálních převodních funkcí, nebo pokud double hodnota vrácená nástrojem Ceiling je automaticky převedena na celé číslo s Option Strict nastavena na Vypnuto. Tato optimalizace umožňuje rychlejší spouštění kódu – 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)