Math.Ceiling Metoda

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

Návraty

Decimal

Nejmenší celočíselná hodnota, která je větší než nebo rovna d .The smallest integral value that is greater than or equal to d. Všimněte si, že tato metoda vrátí Decimal místo celočíselného typu.Note that this method returns a Decimal instead of an integral type.

Příklady

Následující příklad ilustruje Math.Ceiling(Decimal) metodu a kontrastuje ji s Floor(Decimal) metodou.The following example illustrates the Math.Ceiling(Decimal) method and contrasts it with the Floor(Decimal) method.

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

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.The behavior of this method follows IEEE Standard 754, section 4. Tento druh zaokrouhlování se někdy nazývá zaokrouhlení směrem ke kladnému nekonečnu.This kind of rounding is sometimes called rounding toward positive infinity. Jinými slovy, pokud d je pozitivní, přítomnost jakékoli zlomkové komponenty způsobí d zaokrouhlení na nejbližší nejvyšší celé číslo.In other words, if d is positive, the presence of any fractional component causes d to be rounded to the next highest integer. Je-li d hodnota záporná, operace zaokrouhlení způsobí ztrátu jakékoli zlomkové komponenty d .If d is negative, the rounding operation causes any fractional component of d to be discarded. Operace této metody se liší od Floor(Decimal) metody, která podporuje zaokrouhlení směrem k zápornému nekonečnu.The operation of this method differs from the Floor(Decimal) method, which supports rounding toward negative infinity.

Viz také

• Round
• Floor(Decimal)

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

Návraty

Double

Nejmenší celočíselná hodnota, která je větší než nebo rovna a .The smallest integral value that is greater than or equal to a. Pokud a je rovno NaN , NegativeInfinity nebo, PositiveInfinity je vrácena tato hodnota.If a is equal to NaN, NegativeInfinity, or PositiveInfinity, that value is returned. Všimněte si, že tato metoda vrátí Double místo celočíselného typu.Note that this method returns a Double instead of an integral type.

Příklady

Následující příklad ilustruje Math.Ceiling(Double) metodu a kontrastuje ji s Floor(Double) metodou.The following example illustrates the Math.Ceiling(Double) method and contrasts it with the Floor(Double) method.

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

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.The behavior of this method follows IEEE Standard 754, section 4. Tento druh zaokrouhlování se někdy nazývá zaokrouhlení směrem ke kladnému nekonečnu.This kind of rounding is sometimes called rounding toward positive infinity. Jinými slovy, pokud a je pozitivní, přítomnost jakékoli zlomkové komponenty způsobí a zaokrouhlení na nejbližší nejvyšší celé číslo.In other words, if a is positive, the presence of any fractional component causes a to be rounded to the next highest integer. Je-li a hodnota záporná, operace zaokrouhlení způsobí ztrátu jakékoli zlomkové komponenty a .If a is negative, the rounding operation causes any fractional component of a to be discarded. Operace této metody se liší od Floor(Double) metody, která podporuje zaokrouhlení směrem k zápornému nekonečnu.The operation of this method differs from the Floor(Double) method, which supports rounding toward negative infinity.

Počínaje Visual Basic 15,8 je výkon převodu typu Double-to-Integer optimalizován, Pokud předáte hodnotu vrácenou Ceiling metodou do kterékoli z celočíselných funkcí převodunebo pokud hodnota Double vrácená funkcí Ceiling je automaticky převedena na celé číslo s možností stricted nastavenou na hodnotu OFF.Starting with Visual Basic 15.8, the performance of Double-to-integer conversion is optimized if you pass the value returned by the Ceiling method to the any of the integral conversion functions, or if the Double value returned by Ceiling is automatically converted to an integer with Option Strict set to Off. Tato optimalizace umožňuje, aby kód běžel rychleji – až dvakrát pro kód, který provádí velký počet převodů na celočíselné typy.This optimization allows code to run faster -- up to twice as fast for code that does a large number of conversions to integer types. Následující příklad znázorňuje tyto optimalizované převody:The following example illustrates such optimized conversions:

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)