Math.Floor Methode

Definition

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Zahl ist.Returns the largest integral value less than or equal to the specified number.

Überlädt

Floor(Double)

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Gleitkommazahl mit doppelter Genauigkeit ist.Returns the largest integral value less than or equal to the specified double-precision floating-point number.

Floor(Decimal)

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Dezimalzahl ist.Returns the largest integral value less than or equal to the specified decimal 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 Bezug auf minus unendlich bezeichnet.This kind of rounding is sometimes called rounding toward negative infinity.

Floor(Double)

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Gleitkommazahl mit doppelter Genauigkeit ist.Returns the largest integral value less than or equal to the specified double-precision floating-point number.

public:
 static double Floor(double d);
public static double Floor (double d);
static member Floor : double -> double
Public Shared Function Floor (d As Double) As Double

Parameter

d
Double

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

Gibt zurück

Die größte Ganzzahl, die kleiner oder gleich d ist.The largest integral value less than or equal to d. Wenn d gleich NaN, NegativeInfinity oder PositiveInfinity ist, wird dieser Wert zurückgegeben.If d is equal to NaN, NegativeInfinity, or PositiveInfinity, that value is returned.

Beispiele

Im folgenden Beispiel wird die Math.Floor(Double)-Methode veranschaulicht und der Ceiling(Double)-Methode gegenübersteht.The following example illustrates the Math.Floor(Double) method and contrasts it with the Ceiling(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 Bezug auf minus unendlich bezeichnet.This kind of rounding is sometimes called rounding toward negative infinity. Anders ausgedrückt: Wenn d positiv ist, wird jede beliebige Bruch Komponente abgeschnitten.In other words, if d is positive, any fractional component is truncated. Wenn d negativ ist, bewirkt das vorhanden sein einer Bruchteil-Komponente, dass Sie auf die kleinere ganze Zahl gerundet wird.If d is negative, the presence of any fractional component causes it to be rounded to the smaller integer. Der Vorgang dieser Methode unterscheidet sich von der Ceiling-Methode, die das Runden in Richtung positiv unendlich unterstützt.The operation of this method differs from the Ceiling method, which supports rounding toward positive infinity.

Ab Visual Basic 15,8 wird die Leistung der Konvertierung von Double in Integer optimiert, wenn Sie den von der Floor-Methode zurückgegebenen Wert an die ganzzahligen Konvertierungs Funktionenübergeben oder wenn der von Floor 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 Floor method to the any of the integral conversion functions, or if the Double value returned by Floor 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: 1043

Dim d2 As Double = 7968.4136
Dim i2 As Integer = CInt(Math.Ceiling(d2))        ' Result: 7968

Siehe auch

Floor(Decimal)

Gibt die größte Ganzzahl zurück, die kleiner oder gleich der angegebenen Dezimalzahl ist.Returns the largest integral value less than or equal to the specified decimal number.

public:
 static System::Decimal Floor(System::Decimal d);
public static decimal Floor (decimal d);
static member Floor : decimal -> decimal
Public Shared Function Floor (d As Decimal) As Decimal

Parameter

d
Decimal

Eine Dezimalzahl.A decimal number.

Gibt zurück

Die größte Ganzzahl, die kleiner oder gleich d ist.The largest integral value less than or equal to d. Beachten Sie, dass die Methode einen Ganzzahlwert vom Typ Decimal zurückgibt.Note that the method returns an integral value of type Decimal.

Beispiele

Im folgenden Beispiel wird die Math.Floor(Decimal)-Methode veranschaulicht und der Ceiling(Decimal)-Methode gegenübersteht.The following example illustrates the Math.Floor(Decimal) method and contrasts it with the Ceiling(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 Bezug auf minus unendlich bezeichnet.This kind of rounding is sometimes called rounding toward negative infinity. Anders ausgedrückt: Wenn d positiv ist, wird jede beliebige Bruch Komponente abgeschnitten.In other words, if d is positive, any fractional component is truncated. Wenn d negativ ist, bewirkt das vorhanden sein einer Bruchteil-Komponente, dass Sie auf die kleinere ganze Zahl gerundet wird.If d is negative, the presence of any fractional component causes it to be rounded to the smaller integer. Der Vorgang dieser Methode unterscheidet sich von der Ceiling-Methode, die das Runden in Richtung positiv unendlich unterstützt.The operation of this method differs from the Ceiling method, which supports rounding toward positive infinity.

Siehe auch

Gilt für: