Math.Ceiling Methode

Definition

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

Gibt den kleinsten integralen Wert zurück, der größer oder gleich der angegebenen Zahl ist.

Überlädt

Name Beschreibung
Ceiling(Decimal)

Gibt den kleinsten integralen Wert zurück, der größer oder gleich der angegebenen Dezimalzahl ist.
Ceiling(Double)

Gibt den kleinsten integralen 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 von Rundung wird manchmal als Rundung auf positive Unendlichkeit bezeichnet.

Ceiling(Decimal)

Quelle:
Math.cs
Quelle:
Math.cs
Quelle:
Math.cs
Quelle:
Math.cs
Quelle:
Math.cs

Gibt den kleinsten integralen 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 integrale Wert, der größer oder gleich dist. Beachten Sie, dass diese Methode anstelle eines integralen Typs zurückgibt Decimal .

Beispiele

Das folgende Beispiel veranschaulicht die Math.Ceiling(Decimal) Methode und kontrastiert sie mit der Floor(Decimal) Methode.

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 von Rundung wird manchmal als Rundung auf positive Unendlichkeit bezeichnet. Anders ausgedrückt: Wenn d dies positiv ist, wird d das Vorhandensein einer Bruchkomponente auf die nächste höchste ganze Zahl gerundet. Wenn d dies negativ ist, bewirkt der Rundungsvorgang, dass eine Bruchkomponente d verworfen wird. Der Betrieb dieser Methode unterscheidet sich von der Floor(Decimal) Methode, die das Abrunden auf negative Unendlichkeit unterstützt.

Weitere Informationen

Gilt für:

Ceiling(Double)

Quelle:
Math.cs
Quelle:
Math.cs
Quelle:
Math.cs
Quelle:
Math.cs
Quelle:
Math.cs

Gibt den kleinsten integralen 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 integrale Wert, der größer oder gleich aist. Ist a dieser Wert gleich NaN, NegativeInfinityoder PositiveInfinitywird dieser Wert zurückgegeben. Beachten Sie, dass diese Methode anstelle eines integralen Typs zurückgibt Double .

Beispiele

Das folgende Beispiel veranschaulicht die Math.Ceiling(Double) Methode und kontrastiert sie mit der Floor(Double) Methode.

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 von Rundung wird manchmal als Rundung auf positive Unendlichkeit bezeichnet. Anders ausgedrückt: Wenn a dies positiv ist, wird a das Vorhandensein einer Bruchkomponente auf die nächste höchste ganze Zahl gerundet. Wenn a dies negativ ist, bewirkt der Rundungsvorgang, dass eine Bruchkomponente a verworfen wird. Der Betrieb dieser Methode unterscheidet sich von der Floor(Double) Methode, die das Abrunden auf negative Unendlichkeit unterstützt.

Ab Visual Basic 15,8 ist die Leistung der Konvertierung von Double-to-integer optimiert, wenn Sie den von der Ceiling-Methode zurückgegebenen Wert an eine der integral Konvertierungsfunktionen übergeben, oder wenn der von Ceiling zurückgegebene Double-Wert automatisch in eine ganze Zahl konvertiert wird, wobei Option Strict auf "Aus" festgelegt ist. Mit dieser Optimierung kann Code schneller ausgeführt werden – bis zu doppelt so schnell für Code, der eine große Anzahl von Konvertierungen in ganzzahlige Typen ausführt. Im folgenden Beispiel werden solche optimierten Konvertierungen veranschaulicht:

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: