Import of man-pages 1.70

1 files changed, 70 insertions, 0 deletions

diff --git a/man3/floor.3 b/man3/floor.3
new file mode 100644
index 00000000..055e451c
--- /dev/null
+++ b/man3/floor.3
@@ -0,0 +1,70 @@
+.\" 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 FLOOR 3  2001-05-31 "" "Linux Programmer's Manual"
+.SH NAME
+floor, floorf, floorl \- largest integral value not greater than argument
+.SH SYNOPSIS
+.nf
+.B #include <math.h>
+.sp
+.BI "double floor(double " x );
+.br
+.BI "float floorf(float " x );
+.br
+.BI "long double floorl(long double " x );
+.fi
+.sp
+Link with \-lm.
+.SH DESCRIPTION
+These functions round \fIx\fP down to the nearest integer.
+.SH "RETURN VALUE"
+The rounded integer value. If \fIx\fP is integral or infinite,
+\fIx\fP itself is returned.
+.SH ERRORS
+No errors other than EDOM and ERANGE can occur.
+If \fIx\fP is NaN, then NaN is returned and
+.I errno
+may be set to EDOM.
+.SH NOTES
+SUSv2 and POSIX 1003.1-2001 contain text about overflow (which might set
+.I errno
+to ERANGE, or raise an exception).
+In practice, the result cannot overflow on any current machine,
+so this error-handling stuff is just nonsense.
+(More precisely, overflow can happen only when the maximum value
+of the exponent is smaller than the number of mantissa bits.
+For the IEEE-754 standard 32-bit and 64-bit floating point numbers
+the maximum value of the exponent is 128 (resp. 1024), and the number
+of mantissa bits is 24 (resp. 53).)
+.SH "CONFORMING TO"
+The
+.B floor()
+function conforms to SVID 3, POSIX, BSD 4.3, ISO 9899.
+The other functions are from C99.
+.SH "SEE ALSO"
+.BR ceil (3),
+.BR lrint (3),
+.BR nearbyint (3),
+.BR rint (3),
+.BR round (3),
+.BR trunc (3)