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-Methode gegenübersteht Ceiling(Double) .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-Methode zurückgegebenen Wert Floor
an die ganzzahligen Konvertierungs Funktionenübergeben oder wenn der von zurückgegebene Double-Wert Floor
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
Gilt für:
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-Methode gegenübersteht Ceiling(Decimal) .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.