1dce5f3abSSteve Kargl.\" Copyright (c) 2017 Steven G. Kargl <kargl@FreeBSD.org> 2dce5f3abSSteve Kargl.\" All rights reserved. 3dce5f3abSSteve Kargl.\" 4dce5f3abSSteve Kargl.\" Redistribution and use in source and binary forms, with or without 5dce5f3abSSteve Kargl.\" modification, are permitted provided that the following conditions 6dce5f3abSSteve Kargl.\" are met: 7dce5f3abSSteve Kargl.\" 1. Redistributions of source code must retain the above copyright 8dce5f3abSSteve Kargl.\" notice, this list of conditions and the following disclaimer. 9dce5f3abSSteve Kargl.\" 2. Redistributions in binary form must reproduce the above copyright 10dce5f3abSSteve Kargl.\" notice, this list of conditions and the following disclaimer in the 11dce5f3abSSteve Kargl.\" documentation and/or other materials provided with the distribution. 12dce5f3abSSteve Kargl.\" 13dce5f3abSSteve Kargl.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 14dce5f3abSSteve Kargl.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15dce5f3abSSteve Kargl.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16dce5f3abSSteve Kargl.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 17dce5f3abSSteve Kargl.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18dce5f3abSSteve Kargl.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19dce5f3abSSteve Kargl.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20dce5f3abSSteve Kargl.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21dce5f3abSSteve Kargl.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22dce5f3abSSteve Kargl.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23dce5f3abSSteve Kargl.\" SUCH DAMAGE. 24dce5f3abSSteve Kargl.\" 25dce5f3abSSteve Kargl.Dd April 1, 2017 26dce5f3abSSteve Kargl.Dt SINPI 3 27dce5f3abSSteve Kargl.Os 28dce5f3abSSteve Kargl.Sh NAME 29dce5f3abSSteve Kargl.Nm sinpi , 30dce5f3abSSteve Kargl.Nm sinpif , 31dce5f3abSSteve Kargl.Nm sinpil 32dce5f3abSSteve Kargl.Nd half\(encycle sine functions 33dce5f3abSSteve Kargl.Sh LIBRARY 34dce5f3abSSteve Kargl.Lb libm 35dce5f3abSSteve Kargl.Sh SYNOPSIS 36dce5f3abSSteve Kargl.In math.h 37dce5f3abSSteve Kargl.Ft double 38dce5f3abSSteve Kargl.Fn sinpi "double x" 39dce5f3abSSteve Kargl.Ft float 40dce5f3abSSteve Kargl.Fn sinpif "float x" 41dce5f3abSSteve Kargl.Ft long double 42dce5f3abSSteve Kargl.Fn sinpil "long double x" 43dce5f3abSSteve Kargl.Sh DESCRIPTION 44dce5f3abSSteve KarglThe 45dce5f3abSSteve Kargl.Fn sinpi , 46dce5f3abSSteve Kargl.Fn sinpif , 47dce5f3abSSteve Kargland 48dce5f3abSSteve Kargl.Fn sinpil 49dce5f3abSSteve Karglfunctions compute the sine of 50dce5f3abSSteve Kargl.Fa "\(*p \(mu x" . 51dce5f3abSSteve Kargland measure angles in half-cycles. 52dce5f3abSSteve Kargl.Sh RETURN VALUES 53dce5f3abSSteve KarglThe 54dce5f3abSSteve Kargl.Fn sinpi , 55dce5f3abSSteve Kargl.Fn sinpif , 56dce5f3abSSteve Kargland 57dce5f3abSSteve Kargl.Fn sinpil 58dce5f3abSSteve Karglfunctions returns 59dce5f3abSSteve Kargl.Fn sin "\(*p \(mu x" . 60dce5f3abSSteve KarglIf \*(Bax\*(Ba \*(Ge 2^(p - 1) 61dce5f3abSSteve Karglwhere p is the floating\(enpoint precision of 62dce5f3abSSteve Kargl.Ar x , 63dce5f3abSSteve Karglthen the returned value is \*(Pm0 and it has no significance. 64dce5f3abSSteve Kargl.Sh SPECIAL VALUES 65*10343013SGraham Percival.Bl -tag -width "sinpi(NaN)" 66*10343013SGraham Percival.It Fn sinpi \*(Pm0 67dce5f3abSSteve Karglreturns \*(Pm0. 68*10343013SGraham Percival.It Fn sinpi \*(Pmn 69dce5f3abSSteve Karglreturns \*(Pm0 for positive integers 70dce5f3abSSteve Kargl.Ar n . 71*10343013SGraham Percival.It Fn sinpi \*(Pm\(if 72dce5f3abSSteve Karglreturn an \*(Na and raises an FE_INVALID exception. 73*10343013SGraham Percival.It Fn sinpi \*(Na 74dce5f3abSSteve Karglreturn an \*(Na and raises an FE_INVALID exception. 75dce5f3abSSteve Kargl.El 76dce5f3abSSteve Kargl.Sh SEE ALSO 77dce5f3abSSteve Kargl.Xr cos 3 , 78dce5f3abSSteve Kargl.Xr cospi 3 , 79dce5f3abSSteve Kargl.Xr fenv 3 , 80dce5f3abSSteve Kargl.Xr math 3 , 81dce5f3abSSteve Kargl.Xr sin 3 , 82dce5f3abSSteve Kargl.Xr tan 3 , 83dce5f3abSSteve Kargl.Xr tanpi 3 84dce5f3abSSteve Kargl.Sh AUTHORS 85dce5f3abSSteve KarglThe half\(encycle trignometric functions were written by 86dce5f3abSSteve Kargl.An Steven G. Kargl Aq Mt kargl@FreeBSD.org . 87dce5f3abSSteve Kargl.Sh STANDARDS 88dce5f3abSSteve KarglThese functions conform to 89dce5f3abSSteve KarglIEEE Std 754\(tm\(en2008 , 90dce5f3abSSteve Kargl\(dqIEEE Standard for Floating-Point Arithmetic\(dq 91dce5f3abSSteve Kargland to 92dce5f3abSSteve KarglISO/IEC TS 18661-4 , 93dce5f3abSSteve Kargl\(dqInformation technology \(em Programming languages, their environments, 94dce5f3abSSteve Kargland system software interfaces \(em Floating\(enpoint extensions for 95dce5f3abSSteve KarglC\(dq \(em Part 4: Supplementary functions. 96dce5f3abSSteve Kargl 97