Math.Ceiling Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne la valeur du plus petit entier supérieur ou égal au nombre spécifié.
Surcharges
| Ceiling(Decimal) |
Retourne la plus petite valeur intégrale supérieure ou égale au nombre décimal spécifié. |
| Ceiling(Double) |
Retourne la plus petite valeur intégrale supérieure ou égale au nombre à virgule flottante double précision spécifié. |
Remarques
Le comportement de cette méthode est conforme à la norme IEEE 754, section 4. Ce type d’arrondi est parfois appelé arrondi vers l’infini positif.
Ceiling(Decimal)
Retourne la plus petite valeur intégrale supérieure ou égale au nombre décimal spécifié.
public:
static System::Decimal Ceiling(System::Decimal d);public static decimal Ceiling (decimal d);static member Ceiling : decimal -> decimalPublic Shared Function Ceiling (d As Decimal) As DecimalParamètres
- d
- Decimal
Nombre décimal.
Retours
Plus petite valeur intégrale qui est supérieure ou égale à d. Notez que cette méthode retourne un objet Decimal plutôt qu'un type intégral.
Exemples
L’exemple suivant illustre la Math.Ceiling(Decimal) méthode et la compare à la Floor(Decimal) méthode.
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. Ce type d’arrondi est parfois appelé arrondi vers l’infini positif. En d’autres termes, si d est positif, la présence de tout composant fractionnaire est d arrondie à l’entier le plus élevé suivant. Si d est négatif, l’opération d’arrondi entraîne la suppression de tout composant fractionnaire de d . 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.
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é.
public:
static double Ceiling(double a);public static double Ceiling (double a);static member Ceiling : double -> doublePublic Shared Function Ceiling (a As Double) As DoubleParamètres
- a
- Double
Nombre à virgule flottante double précision.
Retours
Plus petite valeur intégrale qui est supérieure ou égale à a. Si a est égal à NaN, à NegativeInfinity ou à PositiveInfinity, cette valeur est retournée. Notez que cette méthode retourne un objet Double plutôt qu'un type intégral.
Exemples
L’exemple suivant illustre la Math.Ceiling(Double) méthode et la compare à la Floor(Double) méthode.
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. Ce type d’arrondi est parfois appelé arrondi vers l’infini positif. En d’autres termes, si a est positif, la présence de tout composant fractionnaire est a arrondie à l’entier le plus élevé suivant. Si a est négatif, l’opération d’arrondi entraîne la suppression de tout composant fractionnaire de a . 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.
à 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. 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). L’exemple suivant illustre ces conversions optimisées :
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