System Grab Bag

View all man pages from Linux (or from all projects)

Name

trunc, truncf, truncl - round to integer, toward zero

Library

Math library ( libm ", " -lm )

Synopsis

#include <math.h> 
double trunc(double  x );
float truncf(float x );
long double truncl(long double x );

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

trunc() truncf() truncl()

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

Description

These functions round x to the nearest integer value that is not larger in magnitude than x.

Return Value

These functions return the rounded integer value, in floating format.

If x is integral, infinite, or NaN, x itself is returned.

Errors

No errors occur.

Attributes

For an explanation of the terms used in this section, see attributes(7). allbox; lbx lb lb T{ trunc()truncf()truncl()
InterfaceAttributeValue
T}Thread safetyMT-Safe

Standards

C11, POSIX.1-2008.

History

glibc 2.1. C99, POSIX.1-2001.

Notes

The integral value returned by these functions may be too large to store in an integer type ( int , long, etc.). To avoid an overflow, which will produce undefined results, an application should perform a range check on the returned value before assigning it to an integer type.

See Also

  1. ceil(3),
  2. floor(3),
  3. lrint(3),
  4. nearbyint(3),
  5. rint(3),
  6. round(3)