Math.Ceiling Methode

Definition

Gibt die kleinste Ganzzahl zurück, die größer oder gleich der angegebenen Zahl ist.Returns the smallest integral value greater than or equal to the specified number.

Überlädt

Ceiling(Decimal)

Gibt den kleinsten ganzzahligen Wert zurück, der größer oder gleich der angegebenen Dezimalzahl ist.Returns the smallest integral value that is greater than or equal to the specified decimal number.

Ceiling(Double)

Gibt den kleinsten ganzzahligen Wert zurück, der größer oder gleich der angegebenen Gleitkommazahl mit doppelter Genauigkeit ist.Returns the smallest integral value that is greater than or equal to the specified double-precision floating-point number.

Hinweise

Das Verhalten dieser Methode folgt IEEE Standard 754, Abschnitt 4.The behavior of this method follows IEEE Standard 754, section 4. Diese Art der Rundung wird manchmal als Rundung in Richtung positiv unendlich bezeichnet.This kind of rounding is sometimes called rounding toward positive infinity.

Ceiling(Decimal)

Gibt den kleinsten ganzzahligen Wert zurück, der größer oder gleich der angegebenen Dezimalzahl ist.Returns the smallest integral value that is greater than or equal to the specified decimal number.

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

Parameter

d
Decimal

Eine Dezimalzahl.A decimal number.

Gibt zurück

Der kleinste ganzzahlige Wert, der größer oder gleich d ist.The smallest integral value that is greater than or equal to d. Beachten Sie, dass diese Methode einen Decimal anstelle eines ganzzahligen Typs zurückgibt.Note that this method returns a Decimal instead of an integral type.

Beispiele

Im folgenden Beispiel wird die Math.Ceiling(Decimal)-Methode veranschaulicht und der Floor(Decimal)-Methode gegenübersteht.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

Hinweise

Das Verhalten dieser Methode folgt IEEE Standard 754, Abschnitt 4.The behavior of this method follows IEEE Standard 754, section 4. Diese Art der Rundung wird manchmal als Rundung in Richtung positiv unendlich bezeichnet.This kind of rounding is sometimes called rounding toward positive infinity. Anders ausgedrückt: Wenn d positiv ist, bewirkt das vorhanden sein einer Bruchteil-Komponente, dass d auf die nächsthöhere Ganzzahl gerundet wird.In other words, if d is positive, the presence of any fractional component causes d to be rounded to the next highest integer. Wenn d negativ ist, bewirkt der Rundungs Vorgang, dass alle Bruchteile von d verworfen werden.If d is negative, the rounding operation causes any fractional component of d to be discarded. Der Vorgang dieser Methode unterscheidet sich von der Floor(Decimal)-Methode, die das Runden in Richtung minus unendlich unterstützt.The operation of this method differs from the Floor(Decimal) method, which supports rounding toward negative infinity.

Siehe auch

Ceiling(Double)

Gibt den kleinsten ganzzahligen Wert zurück, der größer oder gleich der angegebenen Gleitkommazahl mit doppelter Genauigkeit ist.Returns the smallest integral value that is greater than or equal to the specified double-precision floating-point number.

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

Parameter

a
Double

Eine Gleitkommazahl mit doppelter Genauigkeit.A double-precision floating-point number.

Gibt zurück

Der kleinste ganzzahlige Wert, der größer oder gleich a ist.The smallest integral value that is greater than or equal to a. Wenn a gleich NaN, NegativeInfinity oder PositiveInfinity ist, wird dieser Wert zurückgegeben.If a is equal to NaN, NegativeInfinity, or PositiveInfinity, that value is returned. Beachten Sie, dass diese Methode einen Double anstelle eines ganzzahligen Typs zurückgibt.Note that this method returns a Double instead of an integral type.

Beispiele

Im folgenden Beispiel wird die Math.Ceiling(Double)-Methode veranschaulicht und der Floor(Double)-Methode gegenübersteht.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

Hinweise

Das Verhalten dieser Methode folgt IEEE Standard 754, Abschnitt 4.The behavior of this method follows IEEE Standard 754, section 4. Diese Art der Rundung wird manchmal als Rundung in Richtung positiv unendlich bezeichnet.This kind of rounding is sometimes called rounding toward positive infinity. Anders ausgedrückt: Wenn a positiv ist, bewirkt das vorhanden sein einer Bruchteil-Komponente, dass a auf die nächsthöhere Ganzzahl gerundet wird.In other words, if a is positive, the presence of any fractional component causes a to be rounded to the next highest integer. Wenn a negativ ist, bewirkt der Rundungs Vorgang, dass alle Bruchteile von a verworfen werden.If a is negative, the rounding operation causes any fractional component of a to be discarded. Der Vorgang dieser Methode unterscheidet sich von der Floor(Double)-Methode, die das Runden in Richtung minus unendlich unterstützt.The operation of this method differs from the Floor(Double) method, which supports rounding toward negative infinity.

Ab Visual Basic 15,8 wird die Leistung der Konvertierung von Double in Integer optimiert, wenn Sie den von der Ceiling-Methode zurückgegebenen Wert an die ganzzahligen Konvertierungs Funktionenübergeben oder wenn der von Ceiling zurückgegebene Double-Wert automatisch in eine ganze Zahl konvertiert wird, bei der die Option Strict auf OFF festgelegt ist.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. Dank dieser Optimierung kann Code schneller ausgeführt werden. Code, der viele Ganzzahltypen konvertiert, wird bis zu doppelt so schnell ausgeführt.This optimization allows code to run faster -- up to twice as fast for code that does a large number of conversions to integer types. Im folgenden Beispiel werden solche optimierten Konvertierungen veranschaulicht: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

Siehe auch

Gilt für: