Math.Ceiling Méthode

Définition

Retourne la valeur du plus petit entier supérieur ou égal au nombre spécifié.Returns the smallest integral value greater than or equal to the specified number.

Surcharges

Ceiling(Decimal)

Retourne la plus petite valeur intégrale supérieure ou égale au nombre décimal spécifié.Returns the smallest integral value that is greater than or equal to the specified decimal number.

Ceiling(Double)

Retourne la plus petite valeur intégrale supérieure ou égale au nombre à virgule flottante double précision spécifié.Returns the smallest integral value that is greater than or equal to the specified double-precision floating-point number.

Remarques

Le comportement de cette méthode est conforme à la norme IEEE 754, section 4.The behavior of this method follows IEEE Standard 754, section 4. Ce type d’arrondi est parfois appelé arrondi vers l’infini positif.This kind of rounding is sometimes called rounding toward positive infinity.

Ceiling(Decimal)

Retourne la plus petite valeur intégrale supérieure ou égale au nombre décimal spécifié.Returns the smallest integral value that is greater than or equal to the specified decimal number.

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

Paramètres

d
Decimal

Nombre décimal.A decimal number.

Retours

Decimal

Plus petite valeur intégrale qui est supérieure ou égale à d.The smallest integral value that is greater than or equal to d. Notez que cette méthode retourne un objet Decimal plutôt qu'un type intégral.Note that this method returns a Decimal instead of an integral type.

Exemples

L’exemple suivant illustre la Math.Ceiling(Decimal) méthode et la compare à la Floor(Decimal) méthode.The following example illustrates the Math.Ceiling(Decimal) method and contrasts it with the Floor(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

Remarques

Le comportement de cette méthode est conforme à la norme IEEE 754, section 4.The behavior of this method follows IEEE Standard 754, section 4. Ce type d’arrondi est parfois appelé arrondi vers l’infini positif.This kind of rounding is sometimes called rounding toward positive infinity. En d’autres termes, si d est positif, la présence de tout composant fractionnaire est d arrondie à l’entier le plus élevé suivant.In other words, if d is positive, the presence of any fractional component causes d to be rounded to the next highest integer. Si d est négatif, l’opération d’arrondi entraîne la suppression de tout composant fractionnaire de d .If d is negative, the rounding operation causes any fractional component of d to be discarded. Le fonctionnement de cette méthode diffère de la Floor(Decimal) méthode, qui prend en charge l’arrondi vers l’infini négatif.The operation of this method differs from the Floor(Decimal) method, which supports rounding toward negative infinity.

Voir aussi

S’applique à

Ceiling(Double)

Retourne la plus petite valeur intégrale supérieure ou égale au nombre à virgule flottante double précision spécifié.Returns the smallest integral value that is greater than or equal to the specified double-precision floating-point number.

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

Paramètres

a
Double

Nombre à virgule flottante double précision.A double-precision floating-point number.

Retours

Double

Plus petite valeur intégrale qui est supérieure ou égale à a.The smallest integral value that is greater than or equal to a. Si a est égal à NaN, à NegativeInfinity ou à PositiveInfinity, cette valeur est retournée.If a is equal to NaN, NegativeInfinity, or PositiveInfinity, that value is returned. Notez que cette méthode retourne un objet Double plutôt qu'un type intégral.Note that this method returns a Double instead of an integral type.

Exemples

L’exemple suivant illustre la Math.Ceiling(Double) méthode et la compare à la Floor(Double) méthode.The following example illustrates the Math.Ceiling(Double) method and contrasts it with the Floor(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

Remarques

Le comportement de cette méthode est conforme à la norme IEEE 754, section 4.The behavior of this method follows IEEE Standard 754, section 4. Ce type d’arrondi est parfois appelé arrondi vers l’infini positif.This kind of rounding is sometimes called rounding toward positive infinity. En d’autres termes, si a est positif, la présence de tout composant fractionnaire est a arrondie à l’entier le plus élevé suivant.In other words, if a is positive, the presence of any fractional component causes a to be rounded to the next highest integer. Si a est négatif, l’opération d’arrondi entraîne la suppression de tout composant fractionnaire de a .If a is negative, the rounding operation causes any fractional component of a to be discarded. Le fonctionnement de cette méthode diffère de la Floor(Double) méthode, qui prend en charge l’arrondi vers l’infini négatif.The operation of this method differs from the Floor(Double) method, which supports rounding toward negative infinity.

À compter de Visual Basic 15,8, les performances de la conversion de double à entier sont optimisées si vous transmettez la valeur retournée par la Ceiling méthode à l’une des fonctions de conversion intégrale, ou si la valeur double retournée par Ceiling est automatiquement convertie en un entier avec option strict définie à OFF.Starting with Visual Basic 15.8, the performance of Double-to-integer conversion is optimized if you pass the value returned by the Ceiling method to the any of the integral conversion functions, or if the Double value returned by Ceiling is automatically converted to an integer with Option Strict set to Off. Cette optimisation permet au code de s’exécuter plus rapidement (jusqu’à deux fois plus rapidement pour le code qui effectue un grand nombre de conversions en types d’entier).This optimization allows code to run faster -- up to twice as fast for code that does a large number of conversions to integer types. L’exemple suivant illustre ces conversions optimisées :The following example illustrates such optimized conversions:

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

Voir aussi

S’applique à