Math.Ceiling Méthode

Définition

Espace de noms:
System
Assemblys:
mscorlib.dll, System.Runtime.Extensions.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Retourne la plus petite valeur intégrale supérieure ou égale au nombre spécifié.

Surcharges

Nom Description
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 IEEE Standard 754, section 4. Ce type d’arrondi est parfois appelé arrondi vers l’infini positif.

Ceiling(Decimal)

Source:
Math.cs
Source:
Math.cs
Source:
Math.cs
Source:
Math.cs
Source:
Math.cs

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

Decimal

Valeur intégrale la plus petite supérieure ou égale à d. Notez que cette méthode retourne un Decimal type intégral au lieu d’un type intégral.

Exemples

L’exemple suivant illustre la Math.Ceiling(Decimal) méthode et la contraste avec 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 IEEE Standard 754, section 4. Ce type d’arrondi est parfois appelé arrondi vers l’infini positif. En d’autres termes, s’il d est positif, la présence d’un composant fractionnaire entraîne d l’arrondi à l’entier le plus élevé suivant. Si d elle est négative, l’opération d’arrondi entraîne l’abandon d’un d composant fractionnaire. L’opération de cette méthode diffère de la méthode, qui prend en charge l’arrondi vers l’infini Floor(Decimal) négatif.

Voir aussi

S’applique à

Ceiling(Double)

Source:
Math.cs
Source:
Math.cs
Source:
Math.cs
Source:
Math.cs
Source:
Math.cs

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

Double

Valeur intégrale la plus petite supérieure ou égale à a. Si a elle est égale à NaN, NegativeInfinityou PositiveInfinity, cette valeur est retournée. Notez que cette méthode retourne un Double type intégral au lieu d’un type intégral.

Exemples

L’exemple suivant illustre la Math.Ceiling(Double) méthode et la contraste avec 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 IEEE Standard 754, section 4. Ce type d’arrondi est parfois appelé arrondi vers l’infini positif. En d’autres termes, s’il a est positif, la présence d’un composant fractionnaire entraîne a l’arrondi à l’entier le plus élevé suivant. Si a elle est négative, l’opération d’arrondi entraîne l’abandon d’un a composant fractionnaire. L’opération de cette méthode diffère de la méthode, qui prend en charge l’arrondi vers l’infini Floor(Double) négatif.

À compter de Visual Basic 15.8, les performances de la conversion double-à-entier sont optimisées si vous transmettez la valeur retournée par la méthode Ceiling à l’une des fonctions de conversion integral, ou si la valeur double retournée par Ceiling est automatiquement convertie en entier avec Option Strict défini sur Désactivé. Cette optimisation permet au code d’exécuter plus rapidement , jusqu’à deux fois plus rapide pour le code qui effectue un grand nombre de conversions en types entiers. 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 à