floor, floorf, floorl

Calcula a base de um valor.

Sintaxe

double floor(
   double x
);
float floor(
   float x
); // C++ only
long double floor(
   long double x
); // C++ only
float floorf(
   float x
);
long double floorl(
   long double x
);
#define floor(X) // Requires C11 or higher

Parâmetros

x
Valor de ponto flutuante.

Valor retornado

As funções floor retornam um valor de ponto flutuante que representa o maior inteiro menor ou igual a x. Não há retorno de erro.

Entrada Exceção SEH Exceção _matherr
± QNaN, IND nenhum _DOMAIN

floor tem uma implementação que usa SSE2 (Extensões SIMD de Streaming 2). Para obter informações e restrições relativas ao uso da implementação de SSE2, confira _set_SSE2_enable.

Comentários

O C++ permite sobrecargas, de modo que é possível chamar sobrecargas de floor que usam e retornam valores de float e long double. Em um programa C, a menos que esteja usando a macro <tgmath.h> para chamar essa função, floor sempre recebe e retorna um double.

Se você usa a macro <tgmath.h>floor(), o tipo do argumento determina qual versão da função será selecionada. Confira Matemática do tipo genérico para obter detalhes.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Função Cabeçalho necessário
floor, floorf, floorl <math.h>
Macro floor <tgmath.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_floor.c
// This example displays the largest integers
// less than or equal to the floating-point values 2.8
// and -2.8. It then shows the smallest integers greater
// than or equal to 2.8 and -2.8.

#include <math.h>
#include <stdio.h>

int main( void )
{
   double y;

   y = floor( 2.8 );
   printf( "The floor of 2.8 is %f\n", y );
   y = floor( -2.8 );
   printf( "The floor of -2.8 is %f\n", y );

   y = ceil( 2.8 );
   printf( "The ceil of 2.8 is %f\n", y );
   y = ceil( -2.8 );
   printf( "The ceil of -2.8 is %f\n", y );
}
The floor of 2.8 is 2.000000
The floor of -2.8 is -3.000000
The ceil of 2.8 is 3.000000
The ceil of -2.8 is -2.000000

Confira também

Suporte matemático e de ponto flutuante
ceil, ceilf, ceill
round, roundf, roundl
fmod, fmodf