xref: /freebsd/lib/msun/man/nextafter.3 (revision fbbd9655e5107c68e4e0146ff22b73d7350475bc)
129bf6af8SDavid Schultz.\" Copyright (c) 1985, 1991 Regents of the University of California.
229bf6af8SDavid Schultz.\" All rights reserved.
329bf6af8SDavid Schultz.\"
429bf6af8SDavid Schultz.\" Redistribution and use in source and binary forms, with or without
529bf6af8SDavid Schultz.\" modification, are permitted provided that the following conditions
629bf6af8SDavid Schultz.\" are met:
729bf6af8SDavid Schultz.\" 1. Redistributions of source code must retain the above copyright
829bf6af8SDavid Schultz.\"    notice, this list of conditions and the following disclaimer.
929bf6af8SDavid Schultz.\" 2. Redistributions in binary form must reproduce the above copyright
1029bf6af8SDavid Schultz.\"    notice, this list of conditions and the following disclaimer in the
1129bf6af8SDavid Schultz.\"    documentation and/or other materials provided with the distribution.
12*fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors
1329bf6af8SDavid Schultz.\"    may be used to endorse or promote products derived from this software
1429bf6af8SDavid Schultz.\"    without specific prior written permission.
1529bf6af8SDavid Schultz.\"
1629bf6af8SDavid Schultz.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
1729bf6af8SDavid Schultz.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1829bf6af8SDavid Schultz.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1929bf6af8SDavid Schultz.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2029bf6af8SDavid Schultz.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2129bf6af8SDavid Schultz.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2229bf6af8SDavid Schultz.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2329bf6af8SDavid Schultz.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2429bf6af8SDavid Schultz.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2529bf6af8SDavid Schultz.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2629bf6af8SDavid Schultz.\" SUCH DAMAGE.
2729bf6af8SDavid Schultz.\"
2829bf6af8SDavid Schultz.\"     from: @(#)ieee.3	6.4 (Berkeley) 5/6/91
2929bf6af8SDavid Schultz.\" $FreeBSD$
3029bf6af8SDavid Schultz.\"
316af2c5a6SDavid Schultz.Dd May 4, 2005
3229bf6af8SDavid Schultz.Dt NEXTAFTER 3
3329bf6af8SDavid Schultz.Os
3429bf6af8SDavid Schultz.Sh NAME
3529bf6af8SDavid Schultz.Nm nextafter ,
366af2c5a6SDavid Schultz.Nm nextafterf ,
376af2c5a6SDavid Schultz.Nm nextafterl ,
386af2c5a6SDavid Schultz.Nm nexttoward ,
396af2c5a6SDavid Schultz.Nm nexttowardf ,
406af2c5a6SDavid Schultz.Nm nexttowardl
4129bf6af8SDavid Schultz.Nd next representable value
4229bf6af8SDavid Schultz.Sh LIBRARY
4329bf6af8SDavid Schultz.Lb libm
4429bf6af8SDavid Schultz.Sh SYNOPSIS
4529bf6af8SDavid Schultz.In math.h
4629bf6af8SDavid Schultz.Ft double
4729bf6af8SDavid Schultz.Fn nextafter "double x" "double y"
4829bf6af8SDavid Schultz.Ft float
4929bf6af8SDavid Schultz.Fn nextafterf "float x" "float y"
506af2c5a6SDavid Schultz.Ft long double
516af2c5a6SDavid Schultz.Fn nextafterl "long double x" "long double y"
526af2c5a6SDavid Schultz.Ft double
536af2c5a6SDavid Schultz.Fn nexttoward "double x" "long double y"
546af2c5a6SDavid Schultz.Ft float
556af2c5a6SDavid Schultz.Fn nexttowardf "float x" "long double y"
566af2c5a6SDavid Schultz.Ft long double
576af2c5a6SDavid Schultz.Fn nexttowardl "long double x" "long double y"
5829bf6af8SDavid Schultz.Sh DESCRIPTION
596af2c5a6SDavid SchultzThese functions
6029bf6af8SDavid Schultzreturn the next machine representable number from
6129bf6af8SDavid Schultz.Fa x
6229bf6af8SDavid Schultzin direction
6329bf6af8SDavid Schultz.Fa y .
6429bf6af8SDavid Schultz.Sh SEE ALSO
6529bf6af8SDavid Schultz.Xr ieee 3 ,
6629bf6af8SDavid Schultz.Xr math 3
6729bf6af8SDavid Schultz.Sh STANDARDS
6829bf6af8SDavid SchultzThe
696af2c5a6SDavid Schultz.Fn nextafter ,
706af2c5a6SDavid Schultz.Fn nextafterf ,
716af2c5a6SDavid Schultz.Fn nextafterl ,
726af2c5a6SDavid Schultz.Fn nexttoward ,
736af2c5a6SDavid Schultz.Fn nexttowardf ,
7429bf6af8SDavid Schultzand
756af2c5a6SDavid Schultz.Fn nexttowardl
7629bf6af8SDavid Schultzroutines conform to
7729bf6af8SDavid Schultz.St -isoC-99 .
7829bf6af8SDavid SchultzThey implement the Nextafter function recommended by
7929bf6af8SDavid Schultz.St -ieee754 ,
8029bf6af8SDavid Schultzwith the extension that
810af928e2SBaptiste Daroussin.Fn nextafter "+0.0" "-0.0"
8229bf6af8SDavid Schultzreturns
8329bf6af8SDavid Schultz.Li -0.0 ,
8429bf6af8SDavid Schultzand
850af928e2SBaptiste Daroussin.Fn nextafter "-0.0" "+0.0"
8629bf6af8SDavid Schultzreturns
8729bf6af8SDavid Schultz.Li +0.0 .
8829bf6af8SDavid Schultz.Sh HISTORY
8929bf6af8SDavid SchultzThe
9029bf6af8SDavid Schultz.Fn nextafter
9129bf6af8SDavid Schultzfunction appeared in
9229bf6af8SDavid Schultz.Bx 4.3 ,
9329bf6af8SDavid Schultzand
9429bf6af8SDavid Schultz.Fn nextafterf
9529bf6af8SDavid Schultzappeared in
9629bf6af8SDavid Schultz.Fx 2.0 .
97