summaryrefslogtreecommitdiffstats
path: root/man3/lrint.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/lrint.3')
-rw-r--r--man3/lrint.366
1 files changed, 66 insertions, 0 deletions
diff --git a/man3/lrint.3 b/man3/lrint.3
new file mode 100644
index 000000000..e28c76ea7
--- /dev/null
+++ b/man3/lrint.3
@@ -0,0 +1,66 @@
+.\" Copyright 2001 Andries Brouwer <aeb@cwi.nl>.
+.\"
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one.
+.\"
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date. The author(s) assume no
+.\" responsibility for errors or omissions, or for damages resulting from
+.\" the use of the information contained herein. The author(s) may not
+.\" have taken the same level of care in the production of this manual,
+.\" which is licensed free of charge, as they might when working
+.\" professionally.
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\"
+.TH LRINT 3 2001-05-31 "" "Linux Programmer's Manual"
+.SH NAME
+lrint, lrintf, lrintl, llrint, llrintf, llrintl \- round to nearest integer
+.SH SYNOPSIS
+.nf
+.B #include <math.h>
+.sp
+.BI "long int lrint(double " x );
+.br
+.BI "long int lrintf(float " x );
+.br
+.BI "long int lrintl(long double " x );
+.sp
+.BI "long long int llrint(double " x );
+.br
+.BI "long long int llrintf(float " x );
+.br
+.BI "long long int llrintl(long double " x );
+.fi
+.sp
+Link with \-lm.
+.SH DESCRIPTION
+These functions round their argument to the nearest integer value,
+using the current rounding direction.
+If \fIx\fP is infinite or NaN, or if the rounded value is outside
+the range of the return type, the numeric result is unspecified.
+A domain error may occur if the magnitude of \fIx\fP is too large.
+.SH "RETURN VALUE"
+The rounded integer value.
+.SH ERRORS
+.TP
+.B EDOM
+The magnitude of \fIx\fP is too large and
+.I "(math_errhandling & MATH_ERRNO)"
+is non-zero.
+.SH "CONFORMING TO"
+C99.
+.SH "SEE ALSO"
+.BR ceil (3),
+.BR floor (3),
+.BR lround (3),
+.BR nearbyint (3),
+.BR rint (3),
+.BR round (3)