xref: /openbsd-src/lib/libm/man/rint.3 (revision 86f9d4cdda0e0267dccd8755ac0035525579c4a7)
1*86f9d4cdStedu.\"	$OpenBSD: rint.3,v 1.14 2013/06/05 03:40:26 tedu Exp $
2df930be7Sderaadt.\" Copyright (c) 1985, 1991 Regents of the University of California.
3df930be7Sderaadt.\" All rights reserved.
4df930be7Sderaadt.\"
5df930be7Sderaadt.\" Redistribution and use in source and binary forms, with or without
6df930be7Sderaadt.\" modification, are permitted provided that the following conditions
7df930be7Sderaadt.\" are met:
8df930be7Sderaadt.\" 1. Redistributions of source code must retain the above copyright
9df930be7Sderaadt.\"    notice, this list of conditions and the following disclaimer.
10df930be7Sderaadt.\" 2. Redistributions in binary form must reproduce the above copyright
11df930be7Sderaadt.\"    notice, this list of conditions and the following disclaimer in the
12df930be7Sderaadt.\"    documentation and/or other materials provided with the distribution.
136580fee3Smillert.\" 3. Neither the name of the University nor the names of its contributors
14df930be7Sderaadt.\"    may be used to endorse or promote products derived from this software
15df930be7Sderaadt.\"    without specific prior written permission.
16df930be7Sderaadt.\"
17df930be7Sderaadt.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
18df930be7Sderaadt.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19df930be7Sderaadt.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20df930be7Sderaadt.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21df930be7Sderaadt.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22df930be7Sderaadt.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23df930be7Sderaadt.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24df930be7Sderaadt.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25df930be7Sderaadt.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26df930be7Sderaadt.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27df930be7Sderaadt.\" SUCH DAMAGE.
28df930be7Sderaadt.\"
29df930be7Sderaadt.\"     from: @(#)rint.3	5.1 (Berkeley) 5/2/91
30df930be7Sderaadt.\"
31*86f9d4cdStedu.Dd $Mdocdate: June 5 2013 $
32df930be7Sderaadt.Dt RINT 3
33df930be7Sderaadt.Os
34df930be7Sderaadt.Sh NAME
35aa633836Smartynas.Nm nearbyint ,
36aa633836Smartynas.Nm nearbyintf ,
37aa633836Smartynas.Nm nearbyintl ,
388a2f5500Sderaadt.Nm rint ,
39854ac34eSmartynas.Nm rintf ,
40854ac34eSmartynas.Nm rintl
41df930be7Sderaadt.Nd round to integral value in floating-point format
42df930be7Sderaadt.Sh SYNOPSIS
43*86f9d4cdStedu.In math.h
44df930be7Sderaadt.Ft double
45aa633836Smartynas.Fn nearbyint "double x"
46aa633836Smartynas.Ft float
47aa633836Smartynas.Fn nearbyintf "float x"
48aa633836Smartynas.Ft long double
49aa633836Smartynas.Fn nearbyintl "long double x"
50aa633836Smartynas.Ft double
51df930be7Sderaadt.Fn rint "double x"
52df930be7Sderaadt.Ft float
53df930be7Sderaadt.Fn rintf "float x"
54854ac34eSmartynas.Ft long double
55854ac34eSmartynas.Fn rintl "long double x"
56df930be7Sderaadt.Sh DESCRIPTION
57df930be7SderaadtThe
58aa633836Smartynas.Fn rint ,
59aa633836Smartynas.Fn rintf ,
60aa633836Smartynasand
61aa633836Smartynas.Fn rintl
62aa633836Smartynasfunctions return the integral value nearest to
63df930be7Sderaadt.Fa x
64df930be7Sderaadtaccording to the prevailing rounding mode.
65aa633836Smartynas.Pp
6607fc7eacSjasonThe
67aa633836Smartynas.Fn nearbyint ,
68aa633836Smartynas.Fn nearbyintf ,
69aa633836Smartynasand
70aa633836Smartynas.Fn nearbyintl
710fde9a44Sjmcfunctions do the same,
720fde9a44Sjmcbut without raising the
73aa633836Smartynas.Dq inexact
74aa633836Smartynasfloating-point exception.
75df930be7Sderaadt.Sh SEE ALSO
76df930be7Sderaadt.Xr abs 3 ,
77df930be7Sderaadt.Xr ceil 3 ,
78350bb3b8Salex.Xr fabs 3 ,
790714f1f8Smartynas.Xr floor 3
80df930be7Sderaadt.Sh HISTORY
81df930be7SderaadtA
82df930be7Sderaadt.Fn rint
83df930be7Sderaadtfunction appeared in
84df930be7Sderaadt.At v6 .
85