std::ceil, std::ceilf, std::ceill - cppreference.com

1-5) Calcula el valor entero más pequeño no menor que arg.

6) Un conjunto de sobrecargas o una plantilla de función que acepta un argumento de cualquier tipo entero. Equivalente a (3) (el argumento se convierte a double).

Parámetros

Valor de retorno

Si no se producen errores, se devuelve el valor entero más pequeño no menor que arg, es decir, ⌈arg⌉.

Manejo de errores

Los errores se informan como se especifica en math_errhandling.

Si la implementación admite la aritmética de punto flotante IEEE (IEC 60559),

• El modo de redondeo actual no tiene efecto.
• Si arg es +∞ se devuelve +∞.
• Si arg es -∞, se devuelve -∞.
• Si arg es +0, se devuelve +0.
• Si arg es -0, se devuelve -0.
• Si arg es NaN, se devuelve NaN.

Notas

Se puede generar FE_INEXACT (pero no es obligatorio que lo sea) al redondear un valor finito no entero.

Los valores de punto flotante representables más grandes son enteros exactos en todos los formatos de punto flotante estándar, por lo que esta función nunca se desborda por sí sola; sin embargo, el resultado puede desbordar cualquier tipo de entero (incluido std::intmax_t), cuando se almacena en una variable entera.

Esta función (para un argumento double) se comporta como si estuviera implementada por el siguiente código (excepto por la libertad de no generar FE_INEXACT):

#include <cmath>
#include <cfenv>
#pragma STDC FENV_ACCESS ON
double ceil(double x)
{
    double result;
    int save_round = std::fegetround();
    std::fesetround(FE_UPWARD);
    result = std::rint(x); //ostd::nearbyint 
    std::fesetround(save_round);
    return result;
}

Ejemplo

#include <cmath>
#include <iostream>
int main()
{
    std::cout << std::fixed
              << "ceil(+2.4) = " << std::ceil(+2.4) << '\n'
              << "ceil(-2.4) = " << std::ceil(-2.4) << '\n'
              << "ceil(-0.0) = " << std::ceil(-0.0) << '\n'
              << "ceil(-Inf) = " << std::ceil(-INFINITY) << '\n';
}

ceil(+2.4) = 3.000000
ceil(-2.4) = -2.000000
ceil(-0.0) = -0.000000
ceil(-Inf) = -inf

Véase también