Namespaces
Variants

std:: floor, std:: floorf, std:: floorl

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
floor
(C++11) (C++11) (C++11)
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
Definido en el encabezado <cmath>
(1)
float floor ( float num ) ;

double floor ( double num ) ;

long double floor ( long double num ) ;
(hasta C++23)
constexpr /*floating-point-type*/
floor ( /*floating-point-type*/ num ) ;
(desde C++23)
float floorf ( float num ) ;
(2) (desde C++11)
(constexpr desde C++23)
long double floorl ( long double num ) ;
(3) (desde C++11)
(constexpr desde C++23)
Sobrecarga SIMD (desde C++26)
Definido en el encabezado <simd>
template < /*math-floating-point*/ V >

constexpr /*deduced-simd-t*/ < V >

floor ( const V & v_num ) ;
(S) (desde C++26)
Definido en el encabezado <cmath>
template < class Integer >
double floor ( Integer num ) ;
(A) (constexpr desde C++23)
1-3) Calcula el valor entero más grande no mayor que num . La biblioteca proporciona sobrecargas de std::floor para todos los tipos de punto flotante sin calificación cv como el tipo del parámetro. (desde C++23)
S) La sobrecarga SIMD realiza un std::floor elemento por elemento en v_num .
(Ver math-floating-point y deduced-simd-t para sus definiciones.)
(desde C++26)
A) Se proporcionan sobrecargas adicionales para todos los tipos enteros, los cuales son tratados como double .
(since C++11)

Contenidos

Parámetros

num - valor de punto flotante o entero

Valor de retorno

Si no ocurren errores, se devuelve el mayor valor entero no mayor que num , es decir ⌊num⌋ .

Valor de retorno
math-floor.svg
num

Manejo de errores

Los errores se reportan como se especifica en math_errhandling .

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

  • El modo de redondeo actual no tiene efecto .
  • Si num es ±∞, se devuelve sin modificaciones.
  • Si num es ±0, se devuelve sin modificaciones.
  • Si num es NaN, se devuelve NaN.

Notas

FE_INEXACT puede (pero no está obligado a) activarse al redondear un valor finito no entero.

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

Las sobrecargas adicionales no requieren ser proporcionadas exactamente como (A) . Solo necesitan ser suficientes para garantizar que para su argumento num de tipo entero, std :: floor ( num ) tenga el mismo efecto que std :: floor ( static_cast < double > ( num ) ) .

Ejemplo

Ejecutar este código 
#include <cmath>
#include <iostream>
int main()
{
    std::cout << std::fixed
              << "floor(+2.7) = " << std::floor(+2.7) << '\n'
              << "floor(-2.7) = " << std::floor(-2.7) << '\n'
              << "floor(-0.0) = " << std::floor(-0.0) << '\n'
              << "floor(-Inf) = " << std::floor(-INFINITY) << '\n';
}

Salida: 

floor(+2.7) = 2.000000
floor(-2.7) = -3.000000
floor(-0.0) = -0.000000
floor(-Inf) = -inf

Véase también

(C++11) (C++11)
entero más cercano no menor que el valor dado
(función)
(C++11) (C++11) (C++11)
entero más cercano no mayor en magnitud que el valor dado
(función)
(C++11) (C++11) (C++11) (C++11) (C++11) (C++11) (C++11) (C++11) (C++11)
entero más cercano, redondeando alejándose de cero en casos intermedios
(función)
Documentación C para floor