ceil(), ceilf()

Round up a value to the next integer

Synopsis:

#include <math.h>

double ceil( double x );

float ceilf( float x );

Since:

BlackBerry 10.0.0

Arguments:

x
The value you want to round.

Library:

libm

Use the -l m option to qcc to link against this library.

Description:

The ceil() and ceilf() functions round the value of x up to the next integer (rounding towards the "ceiling").

Returns:

The smallest integer ≥ x.

If an error occurs, these functions return 0, but this is also a valid mathematical result. If you want to check for errors, set errno to 0, call the function, and then check errno again. These functions don't change errno if no errors occurred.

Examples:

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

int main( void )
{
    printf( "%f %f %f %f %f\n", ceil( -2.1 ), 
      ceil( -2. ), ceil( 0.0 ), ceil( 2. ), 
      ceil( 2.1 ) );

    return EXIT_SUCCESS;
}

produces the output:

-2.000000 -2.000000 0.000000 2.000000 3.000000

Classification:

ANSI, POSIX 1003.1

Safety:  
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus