Math.Ceiling Methode

Definitie

Retourneert de kleinste integrale waarde groter dan of gelijk aan het opgegeven getal.

Overloads

Name Description
Ceiling(Decimal)

Retourneert de kleinste integrale waarde die groter is dan of gelijk is aan het opgegeven decimale getal.

Ceiling(Double)

Retourneert de kleinste integrale waarde die groter is dan of gelijk is aan het opgegeven drijvendekommagetal met dubbele precisie.

Opmerkingen

Het gedrag van deze methode volgt IEEE Standard 754, sectie 4. Dit soort afronding wordt ook wel afronding naar positief oneindigheid genoemd.

Ceiling(Decimal)

Retourneert de kleinste integrale waarde die groter is dan of gelijk is aan het opgegeven decimale getal.

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

Parameters

d
Decimal

Een decimaal getal.

Retouren

De kleinste integrale waarde die groter is dan of gelijk is aan d. Houd er rekening mee dat deze methode een Decimal in plaats van een integraal type retourneert.

Voorbeelden

In het volgende voorbeeld ziet u de Math.Ceiling(Decimal) methode en contrasteert deze met de Floor(Decimal) methode.

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

Opmerkingen

Het gedrag van deze methode volgt IEEE Standard 754, sectie 4. Dit soort afronding wordt ook wel afronding naar positief oneindigheid genoemd. Met andere woorden, als d dit positief is, wordt d de aanwezigheid van een breukonderdeel afgerond op het eerstvolgende hoogste gehele getal. Als d dit negatief is, zorgt de afrondingsbewerking ervoor dat een breukonderdeel wordt d verwijderd. De werking van deze methode verschilt van de Floor(Decimal) methode, die ondersteuning biedt voor afronding naar negatieve oneindigheid.

Zie ook

Van toepassing op

Ceiling(Double)

Retourneert de kleinste integrale waarde die groter is dan of gelijk is aan het opgegeven drijvendekommagetal met dubbele precisie.

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

Parameters

a
Double

Een drijvendekommagetal met dubbele precisie.

Retouren

De kleinste integrale waarde die groter is dan of gelijk is aan a. Als a deze waarde gelijk is aan NaN, NegativeInfinityof PositiveInfinity, wordt deze waarde geretourneerd. Houd er rekening mee dat deze methode een Double in plaats van een integraal type retourneert.

Voorbeelden

In het volgende voorbeeld ziet u de Math.Ceiling(Double) methode en contrasteert deze met de Floor(Double) methode.

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

Opmerkingen

Het gedrag van deze methode volgt IEEE Standard 754, sectie 4. Dit soort afronding wordt ook wel afronding naar positief oneindigheid genoemd. Met andere woorden, als a dit positief is, wordt a de aanwezigheid van een breukonderdeel afgerond op het eerstvolgende hoogste gehele getal. Als a dit negatief is, zorgt de afrondingsbewerking ervoor dat een breukonderdeel wordt a verwijderd. De werking van deze methode verschilt van de Floor(Double) methode, die ondersteuning biedt voor afronding naar negatieve oneindigheid.

Vanaf Visual Basic 15,8 worden de prestaties van conversie van double-to-integer geoptimaliseerd als u de waarde die wordt geretourneerd door de methode Ceiling doorgeeft aan een van de integrale conversiefuncties, of als de dubbele waarde die wordt geretourneerd door Ceiling automatisch wordt geconverteerd naar een geheel getal met Option Strict ingesteld op Uit. Met deze optimalisatie kan code sneller worden uitgevoerd, tot twee keer zo snel voor code die een groot aantal conversies naar gehele getallen uitvoert. Het volgende voorbeeld illustreert dergelijke geoptimaliseerde conversies:

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

Zie ook

Van toepassing op