Math.Ceiling Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.Extensions.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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 -> decimal
Public Shared Function Ceiling (d As Decimal) As Decimal

Parameter

d
Decimal

Eine Dezimalzahl

Gibt zurück

Decimal

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 -> double
Public Shared Function Ceiling (a As Double) As Double

Parameter

a
Double

Eine Gleitkommazahl mit doppelter Genauigkeit.

Gibt zurück

Double

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: