Math.Ceiling Méthode

Définition

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 suit 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 -> decimal
Public Shared Function Ceiling (d As Decimal) As Decimal

Paramè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
// 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

Remarques

Le comportement de cette méthode suit 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 d’un composant fractionnaire entraîne d l’arrondi à l’entier le plus élevé suivant. Si d est négatif, l’opération d’arrondi entraîne l’abandon d’un composant fractionnaire de d . Le fonctionnement de cette méthode diffère de la méthode, qui prend en charge l’arrondi Floor(Decimal) 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 -> double
Public Shared Function Ceiling (a As Double) As Double

Paramè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
// 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

Remarques

Le comportement de cette méthode suit 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 d’un composant fractionnaire entraîne a l’arrondi à l’entier le plus élevé suivant. Si a est négatif, l’opération d’arrondi entraîne l’abandon d’un composant fractionnaire de a . Le fonctionnement de cette méthode diffère de la méthode, qui prend en charge l’arrondi Floor(Double) vers l’infini négatif.

À compter de Visual Basic 15.8, les performances de la conversion double en entier sont optimisées si vous transmettez la valeur retournée par la méthode à l’une Ceiling des fonctions de conversion intégrales, ou si la valeur Double retournée par Ceiling est automatiquement convertie en entier avec Option Strict définie sur Désactivé. 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

Voir aussi

S’applique à