# Ceil

Round a double-precision floating-point number toward positive infinity.

## Usage

``````var ceil = require( '@stdlib/math/base/special/ceil' );
``````

#### ceil( x )

Rounds a double-precision floating-point number toward positive infinity.

``````var v = ceil( -4.2 );
// returns -4.0

v = ceil( 9.99999 );
// returns 10.0

v = ceil( 0.0 );
// returns 0.0

v = ceil( NaN );
// returns NaN
``````

## Examples

``````var randu = require( '@stdlib/random/base/randu' );
var ceil = require( '@stdlib/math/base/special/ceil' );

var x;
var i;

for ( i = 0; i < 100; i++ ) {
x = (randu()*100.0) - 50.0;
console.log( 'ceil(%d) = %d', x, ceil( x ) );
}
``````

## C APIs

### Usage

``````#include "stdlib/math/base/special/ceil.h"
``````

#### stdlib_base_ceil( x )

Rounds a double-precision floating-point number toward positive infinity.

``````double y = stdlib_base_ceil( 3.14 );
// returns 4.0
``````

The function accepts the following arguments:

• x: `[in] double` input value.
``````double stdlib_base_ceil( const double x );
``````

### Examples

``````#include "stdlib/math/base/special/ceil.h"
#include <stdio.h>

int main() {
double x[] = { 3.14, -3.14, 0.0, 0.0/0.0 };

double y;
int i;
for ( i = 0; i < 4; i++ ) {
y = stdlib_base_ceil( x[ i ] );
printf( "ceil(%lf) = %lf\n", x[ i ], y );
}
}
``````