| title | ceil, ceilf, ceill | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| description | API ref for calculating the ceiling of a value with ceil(). | |||||||||||||
| ms.date | 9/1/2020 | |||||||||||||
| api_name |
|
|||||||||||||
| api_location |
|
|||||||||||||
| api_type |
|
|||||||||||||
| topic_type |
|
|||||||||||||
| f1_keywords |
|
|||||||||||||
| helpviewer_keywords |
|
|||||||||||||
| ms.assetid | f4e5acab-5c8f-4b10-9ae2-9561e6453718 |
Calculates the ceiling of a value.
double ceil(
double x
);
float ceil(
float x
); // C++ only
long double ceil(
long double x
); // C++ only
float ceilf(
float x
);
long double ceill(
long double x
);
#define ceil(X) // Requires C11 or higherx
Floating-point value.
The ceil functions return a floating-point value that represents the smallest integer that is greater than or equal to x. There's no error return.
| Input | SEH Exception | Matherr Exception |
|---|---|---|
| ± QNAN, IND | none | _DOMAIN |
ceil has an implementation that uses Streaming SIMD Extensions 2 (SSE2). For information and restrictions about using the SSE2 implementation, see _set_SSE2_enable.
Because C++ allows overloading, you can call overloads of ceil that take float or long double types. In a C program, unless you're using the <tgmath.h> macro to call this function, ceil always takes and returns a double.
If you use the <tgmath.h> ceil() macro, the type of the argument determines which version of the function is selected. See Type-generic math for details.
By default, this function's global state is scoped to the application. To change this state, see Global state in the CRT.
| Routine | Required header |
|---|---|
| ceil, ceilf, ceill | <math.h> |
| ceil macro | <tgmath.h> |
For more compatibility information, see Compatibility.
See the example for floor.
Floating-Point Support
floor, floorf, floorl
fmod, fmodf
round, roundf, roundl