Math.Ceiling Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die kleinste Ganzzahl zurück, die größer oder gleich der angegebenen Zahl ist.
Überlädt
| Ceiling(Decimal) |
Gibt den kleinsten ganzzahligen Wert zurück, der größer oder gleich der angegebenen Dezimalzahl ist. |
| Ceiling(Double) |
Gibt den kleinsten ganzzahligen Wert zurück, der größer oder gleich der angegebenen Gleitkommazahl mit doppelter Genauigkeit ist. |
Hinweise
Das Verhalten dieser Methode folgt IEEE Standard 754, Abschnitt 4. Diese Art der Rundung wird manchmal als Rundung in Richtung positive Unendlichkeit bezeichnet.
Ceiling(Decimal)
- Quelle:
- Math.cs
- Quelle:
- Math.cs
- Quelle:
- Math.cs
Gibt den kleinsten ganzzahligen Wert zurück, der größer oder gleich der angegebenen Dezimalzahl ist.
public:
static System::Decimal Ceiling(System::Decimal d);public static decimal Ceiling (decimal d);static member Ceiling : decimal -> decimalPublic Shared Function Ceiling (d As Decimal) As DecimalParameter
- d
- Decimal
Eine Dezimalzahl
Gibt zurück
Der kleinste ganzzahlige Wert, der größer oder gleich d ist. Beachten Sie, dass diese Methode einen Decimal anstelle eines ganzzahligen Typs zurückgibt.
Beispiele
Im folgenden Beispiel wird die Math.Ceiling(Decimal) -Methode veranschaulicht und mit der Floor(Decimal) -Methode kontrastiert.
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
Hinweise
Das Verhalten dieser Methode folgt IEEE Standard 754, Abschnitt 4. Diese Art der Rundung wird manchmal als Rundung in Richtung positive Unendlichkeit bezeichnet. Mit anderen Worten, wenn d positiv ist, führt d das Vorhandensein einer beliebigen Bruchkomponente dazu, auf die nächsthöchste ganze Zahl gerundet zu werden. Wenn d negativ ist, bewirkt der Rundungsvorgang, dass jede Fraktionskomponente von d verworfen wird. Der Vorgang dieser Methode unterscheidet sich von der Methode, die Floor(Decimal) die Rundung in Richtung negative Unendlichkeit unterstützt.
Weitere Informationen
Gilt für:
Ceiling(Double)
- Quelle:
- Math.cs
- Quelle:
- Math.cs
- Quelle:
- Math.cs
Gibt den kleinsten ganzzahligen Wert zurück, der größer oder gleich der angegebenen Gleitkommazahl mit doppelter Genauigkeit ist.
public:
static double Ceiling(double a);public static double Ceiling (double a);static member Ceiling : double -> doublePublic Shared Function Ceiling (a As Double) As DoubleParameter
- a
- Double
Eine Gleitkommazahl mit doppelter Genauigkeit.
Gibt zurück
Der kleinste ganzzahlige Wert, der größer oder gleich a ist. Wenn a gleich NaN, NegativeInfinity oder PositiveInfinity ist, wird dieser Wert zurückgegeben. Beachten Sie, dass diese Methode einen Double anstelle eines ganzzahligen Typs zurückgibt.
Beispiele
Im folgenden Beispiel wird die Math.Ceiling(Double) -Methode veranschaulicht und mit der Floor(Double) -Methode kontrastiert.
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
Hinweise
Das Verhalten dieser Methode folgt IEEE Standard 754, Abschnitt 4. Diese Art der Rundung wird manchmal als Rundung in Richtung positive Unendlichkeit bezeichnet. Mit anderen Worten, wenn a positiv ist, führt a das Vorhandensein einer beliebigen Bruchkomponente dazu, auf die nächsthöchste ganze Zahl gerundet zu werden. Wenn a negativ ist, bewirkt der Rundungsvorgang, dass jede Fraktionskomponente von a verworfen wird. Der Vorgang dieser Methode unterscheidet sich von der Methode, die Floor(Double) die Rundung in Richtung negative Unendlichkeit unterstützt.
Ab Visual Basic 15.8 wird die Leistung der Double-to-Integer-Konvertierung optimiert, wenn Sie den von der Ceiling Methode zurückgegebenen Wert an eine der integralen Konvertierungsfunktionen übergeben oder wenn der von Ceiling zurückgegebene Double-Wert automatisch in eine ganze Zahl konvertiert wird, wobei Option Strict auf Off festgelegt ist. Dank dieser Optimierung kann Code schneller ausgeführt werden. Code, der viele Ganzzahltypen konvertiert, wird bis zu doppelt so schnell ausgeführt. Das folgende Beispiel veranschaulicht solche optimierten Konvertierungen:
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
Weitere Informationen
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für