Math.Ceiling Math.Ceiling Math.Ceiling Math.Ceiling Method

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) Ceiling(Decimal) Ceiling(Decimal) 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) Ceiling(Double) Ceiling(Double) 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.

Beispiele

Hinweis

Die C#-Beispiele in diesem Artikel werden in der Inlinecodeausführung und dem Playground von Try.NET ausgeführt.The C# examples in this article run in the Try.NET inline code runner and playground. Klicken Sie auf die Schaltfläche Ausführen, um ein Beispiel in einem interaktiven Fenster auszuführen.Select the Run button to run an example in an interactive window. Nachdem Sie den Code ausgeführt haben, können Sie ihn ändern und den geänderten Code durch erneutes Anklicken der Schaltfläche Ausführen ausführen.Once you execute the code, you can modify it and run the modified code by selecting Run again. Der geänderte Code wird entweder im interaktiven Fenster ausgeführt, oder das interaktive Fenster zeigt alle C#-Compilerfehlermeldungen an, wenn die Kompilierung fehlschlägt.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

Hinweise

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

Ceiling(Decimal) Ceiling(Decimal) Ceiling(Decimal) 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 Decimal Decimal Decimal

Eine Decimal-Zahl.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

Das folgende Beispiel veranschaulicht die Math.Ceiling(Decimal) Methode und steht im Gegensatz zu mit dem Floor(Decimal) Methode.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 Standard IEEE-754, Abschnitt 4.The behavior of this method follows IEEE Standard 754, section 4. Diese Art der Rundung wird manchmal bezeichnet runden in Richtung plus unendlich.This kind of rounding is sometimes called rounding toward positive infinity. Das heißt, wenn d positiv ist, wird das Vorhandensein von jedem Nachkommawert Ursachen d auf die nächste ganze Zahl gerundet werden soll.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 ist negativ, Rundung bewirkt, dass alle Nachkommawert d verworfen werden.If d is negative, the rounding operation causes any fractional component of d to be discarded. Die Ausführung der Methode unterscheidet sich von der Floor(Decimal) -Methode, die in Richtung minus unendlich Rundung unterstützt.The operation of this method differs from the Floor(Decimal) method, which supports rounding toward negative infinity.

Siehe auch

Ceiling(Double) Ceiling(Double) Ceiling(Double) 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 Double Double 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

Das folgende Beispiel veranschaulicht die Math.Ceiling(Double) Methode und steht im Gegensatz zu mit dem Floor(Double) Methode.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 Standard IEEE-754, Abschnitt 4.The behavior of this method follows IEEE Standard 754, section 4. Diese Art der Rundung wird manchmal bezeichnet runden in Richtung plus unendlich.This kind of rounding is sometimes called rounding toward positive infinity. Das heißt, wenn a positiv ist, wird das Vorhandensein von jedem Nachkommawert Ursachen a auf die nächste ganze Zahl gerundet werden soll.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 ist negativ, Rundung bewirkt, dass alle Nachkommawert a verworfen werden.If a is negative, the rounding operation causes any fractional component of a to be discarded. Die Ausführung der Methode unterscheidet sich von der Floor(Double) -Methode, die in Richtung minus unendlich Rundung unterstützt.The operation of this method differs from the Floor(Double) method, which supports rounding toward negative infinity.

Visual Basic-15.8 ab, die Leistung von doppelten Werten in ganzzahlige Konvertierung wird optimiert, wenn Sie, den Rückgabewert übergeben von der Ceiling Methode, um eines der ganzzahligen Konvertierungsfunktionen, oder wenn der Double-Wert zurückgegebenes Ceiling wird automatisch in eine Ganzzahl mit Vorzeichen konvertiert 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. Das folgende Beispiel veranschaulicht diese optimierte Konvertierungen: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: