IDL

CEIL

CEIL

The CEIL function returns the closest integer greater than or equal to its argument.

Examples


To print the ceiling function of 5.1, enter:

PRINT, CEIL(5.1)
; IDL prints:
6

To print the ceiling function of 3000000000.1, the result of which is too large to represent in a 32-bit integer:

PRINT, CEIL(3000000000.1D, /L64)
; IDL prints:
3000000001

Syntax


Result = CEIL(X [, /L64] )

Return Value


If the input value X is integer type, Result has the same value and type as X. Otherwise, Result is a 32-bit longword integer with the same structure as X.

Arguments


X

The value for which the ceiling function is to be evaluated. This value can be any numeric type (integer, floating, or complex).

Keywords


L64

If set, the result type is 64-bit integer regardless of the input type. This is useful for situations in which a floating point number contains a value too large to be represented in a 32-bit integer.

Thread Pool Keywords

This routine is written to make use of IDL’s thread pool, which can increase execution speed on systems with multiple CPUs. The values stored in the !CPU system variable control whether IDL uses the thread pool for a given computation. In addition, you can use the thread pool keywords TPOOL_MAX_ELTS, TPOOL_MIN_ELTS, and TPOOL_NOTHREAD to override the defaults established by !CPU for a single invocation of this routine. See Thread Pool Keywords for details.

Version History


Pre 4.0

Introduced

See Also


COMPLEXROUND, FLOOR, ROUND

Notes


This page has no user notes yet. Be the first one!


This information is not subject to the controls of the International Traffic in Arms Regulations (ITAR) or the Export Administration Regulations (EAR). However, it may be restricted from transfer to various embargoed countries under U.S. laws and regulations.
© 2014 Exelis Visual Information Solutions