xref: /dflybsd-src/contrib/openbsd_libm/man/sincos.3 (revision 1b963492d9a42a3a322a1de102e0cb457dd626f1)
1*7db632caSSascha Wildner.\"	$OpenBSD: sincos.3,v 1.1 2018/03/10 20:52:58 kettenis Exp $
2*7db632caSSascha Wildner.\" Copyright (c) 2011 Steven G. Kargl.
3*7db632caSSascha Wildner.\"
4*7db632caSSascha Wildner.\" Redistribution and use in source and binary forms, with or without
5*7db632caSSascha Wildner.\" modification, are permitted provided that the following conditions
6*7db632caSSascha Wildner.\" are met:
7*7db632caSSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
8*7db632caSSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
9*7db632caSSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
10*7db632caSSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
11*7db632caSSascha Wildner.\"    documentation and/or other materials provided with the distribution.
12*7db632caSSascha Wildner.\"
13*7db632caSSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
14*7db632caSSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15*7db632caSSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16*7db632caSSascha Wildner.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
17*7db632caSSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18*7db632caSSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19*7db632caSSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20*7db632caSSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21*7db632caSSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22*7db632caSSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23*7db632caSSascha Wildner.\" SUCH DAMAGE.
24*7db632caSSascha Wildner.\"
25*7db632caSSascha Wildner.\" $FreeBSD: head/lib/msun/man/sincos.3 319047 2017-05-28 06:13:38Z mmel $
26*7db632caSSascha Wildner.\"
27*7db632caSSascha Wildner.Dd $Mdocdate: March 10 2018 $
28*7db632caSSascha Wildner.Dt SINCOS 3
29*7db632caSSascha Wildner.Os
30*7db632caSSascha Wildner.Sh NAME
31*7db632caSSascha Wildner.Nm sincos ,
32*7db632caSSascha Wildner.Nm sincosf ,
33*7db632caSSascha Wildner.Nm sincosl
34*7db632caSSascha Wildner.Nd sine and cosine functions
35*7db632caSSascha Wildner.Sh SYNOPSIS
36*7db632caSSascha Wildner.In math.h
37*7db632caSSascha Wildner.Ft void
38*7db632caSSascha Wildner.Fn sincos "double x" "double *s" "double *c"
39*7db632caSSascha Wildner.Ft void
40*7db632caSSascha Wildner.Fn sincosf "float x" "float *s" "float *c"
41*7db632caSSascha Wildner.Ft void
42*7db632caSSascha Wildner.Fn sincosl "long double x" "long double *s" "long double *c"
43*7db632caSSascha Wildner.Sh DESCRIPTION
44*7db632caSSascha WildnerThe
45*7db632caSSascha Wildner.Fn sincos ,
46*7db632caSSascha Wildner.Fn sincosf ,
47*7db632caSSascha Wildnerand
48*7db632caSSascha Wildner.Fn sincosl
49*7db632caSSascha Wildnerfunctions compute the sine and cosine of
50*7db632caSSascha Wildner.Fa x .
51*7db632caSSascha WildnerUsing these functions allows argument reduction to occur only
52*7db632caSSascha Wildneronce instead of twice with individual invocations of
53*7db632caSSascha Wildner.Fn sin
54*7db632caSSascha Wildnerand
55*7db632caSSascha Wildner.Fn cos .
56*7db632caSSascha WildnerLike
57*7db632caSSascha Wildner.Fn sin
58*7db632caSSascha Wildnerand
59*7db632caSSascha Wildner.Fn cos ,
60*7db632caSSascha Wildnera large magnitude argument may yield a result with little
61*7db632caSSascha Wildneror no significance.
62*7db632caSSascha Wildner.Sh RETURN VALUES
63*7db632caSSascha WildnerUpon returning from
64*7db632caSSascha Wildner.Fn sincos ,
65*7db632caSSascha Wildner.Fn sincosf ,
66*7db632caSSascha Wildnerand
67*7db632caSSascha Wildner.Fn sincosl ,
68*7db632caSSascha Wildnerthe objects pointed to by
69*7db632caSSascha Wildner.Ar "*s"
70*7db632caSSascha Wildnerand
71*7db632caSSascha Wildner.Ar "*c"
72*7db632caSSascha Wildnerare assigned the values of sine and cosine, respectively.
73*7db632caSSascha Wildner.Sh SEE ALSO
74*7db632caSSascha Wildner.Xr cos 3 ,
75*7db632caSSascha Wildner.Xr sin 3
76*7db632caSSascha Wildner.Sh HISTORY
77*7db632caSSascha WildnerThese functions first appeared in
78*7db632caSSascha Wildner.Ox 6.3 .
79