xref: /openbsd-src/lib/libm/man/trunc.3 (revision 73d4fc9bd5f7838a0f9b6cdbb145f9c58519a740)
1*73d4fc9bSjmc.\"	$OpenBSD: trunc.3,v 1.8 2013/08/14 06:32:29 jmc Exp $
255dfb921Sbrad.\"
355dfb921Sbrad.\" Copyright (c) 2004, 2005 David Schultz <das@FreeBSD.org>
455dfb921Sbrad.\" All rights reserved.
555dfb921Sbrad.\"
655dfb921Sbrad.\" Redistribution and use in source and binary forms, with or without
755dfb921Sbrad.\" modification, are permitted provided that the following conditions
855dfb921Sbrad.\" are met:
955dfb921Sbrad.\" 1. Redistributions of source code must retain the above copyright
1055dfb921Sbrad.\"    notice, this list of conditions and the following disclaimer.
1155dfb921Sbrad.\" 2. Redistributions in binary form must reproduce the above copyright
1255dfb921Sbrad.\"    notice, this list of conditions and the following disclaimer in the
1355dfb921Sbrad.\"    documentation and/or other materials provided with the distribution.
1455dfb921Sbrad.\"
1555dfb921Sbrad.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
1655dfb921Sbrad.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1755dfb921Sbrad.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1855dfb921Sbrad.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
1955dfb921Sbrad.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2055dfb921Sbrad.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2155dfb921Sbrad.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2255dfb921Sbrad.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2355dfb921Sbrad.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2455dfb921Sbrad.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2555dfb921Sbrad.\" SUCH DAMAGE.
2655dfb921Sbrad.\"
2755dfb921Sbrad.\" $FreeBSD: src/lib/msun/man/trunc.3,v 1.3 2005/06/15 19:04:04 ru Exp $
2855dfb921Sbrad.\"
29*73d4fc9bSjmc.Dd $Mdocdate: August 14 2013 $
3055dfb921Sbrad.Dt TRUNC 3
3155dfb921Sbrad.Os
3255dfb921Sbrad.Sh NAME
3355dfb921Sbrad.Nm trunc ,
347ac6a943Smartynas.Nm truncf ,
357ac6a943Smartynas.Nm truncl
36*73d4fc9bSjmc.Nd nearest integral value with magnitude less than or equal to |x|
3755dfb921Sbrad.Sh SYNOPSIS
3855dfb921Sbrad.In math.h
3955dfb921Sbrad.Ft double
4055dfb921Sbrad.Fn trunc "double x"
4155dfb921Sbrad.Ft float
4255dfb921Sbrad.Fn truncf "float x"
437ac6a943Smartynas.Ft long double
447ac6a943Smartynas.Fn truncl "long double x"
4555dfb921Sbrad.Sh DESCRIPTION
4655dfb921SbradThe
477ac6a943Smartynas.Fn trunc ,
4855dfb921Sbrad.Fn truncf
497ac6a943Smartynasand
507ac6a943Smartynas.Fn truncl
5155dfb921Sbradfunctions return the nearest integral value with magnitude less than
5255dfb921Sbrador equal to
5355dfb921Sbrad.Pf | Fa x Ns | .
5455dfb921SbradThey are equivalent to
557ac6a943Smartynas.Fn rint ,
5655dfb921Sbrad.Fn rintf
577ac6a943Smartynasand
587ac6a943Smartynas.Fn rintl
5997c9a894Smartynasrespectively, in the rounding towards zero mode.
6055dfb921Sbrad.Sh SEE ALSO
6155dfb921Sbrad.Xr ceil 3 ,
623275c9e0Sjmc.Xr fesetround 3 ,
6355dfb921Sbrad.Xr floor 3 ,
6455dfb921Sbrad.Xr nextafter 3 ,
6565850ae2Sbrad.Xr rint 3 ,
6665850ae2Sbrad.Xr round 3
6755dfb921Sbrad.Sh STANDARDS
6855dfb921SbradThe
697ac6a943Smartynas.Fn trunc ,
7055dfb921Sbrad.Fn truncf
717ac6a943Smartynasand
727ac6a943Smartynas.Fn truncl
7355dfb921Sbradfunctions conform to
7455dfb921Sbrad.St -isoC-99 .
75