float asinf( float arg );
(1) (since C99)double asin( double arg );
(2)long double asinl( long double arg );
(3) (since C99)_Decimal32 asind32( _Decimal32 arg );
(4) (since C23)_Decimal64 asind64( _Decimal64 arg );
(5) (since C23)_Decimal128 asind128( _Decimal128 arg );
(6) (since C23)#define asin( arg )
(7) (since C99)1-6) Computes the principal values of the arc sine of arg.
7)Type-generic macro: If the argument has type
long double,
(3)(
asinl
) is called. Otherwise, if the argument has integer type or the type
double,
(2)(
asin
) is called. Otherwise,
(1)(
asinf
) is called. If the argument is complex, then the macro invokes the corresponding complex function (
casinf,
casin,
casinl).
The functions (4-6) are declared if and only if the implementation predefines __STDC_IEC_60559_DFP__ (i.e. the implementation supports decimal floating-point numbers).
If no errors occur, the arc sine of
arg(
arcsin(arg)) in the range
[- ; +], is returned.
If a domain error occurs, an implementation-defined value is returned (NaN where supported).
If a range error occurs due to underflow, the correct result (after rounding) is returned.
[edit] Error handlingErrors are reported as specified in math_errhandling.
Domain error occurs if arg is outside the range [-1.0; 1.0].
If the implementation supports IEEE floating-point arithmetic (IEC 60559):
#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
#include <string.h>
#ifndef __GNUC__
#pragma STDC FENV_ACCESS ON
#endif
int main(void)
{
printf("asin( 1.0) = %+f, 2*asin( 1.0)=%+f\n", asin(1), 2 * asin(1));
printf("asin(-0.5) = %+f, 6*asin(-0.5)=%+f\n", asin(-0.5), 6 * asin(-0.5));
// special values
printf("asin(0.0) = %1f, asin(-0.0)=%f\n", asin(+0.0), asin(-0.0));
// error handling
errno = 0; feclearexcept(FE_ALL_EXCEPT);
printf("asin(1.1) = %f\n", asin(1.1));
if (errno == EDOM)
perror(" errno == EDOM");
if (fetestexcept(FE_INVALID))
puts(" FE_INVALID raised");
}
Possible output:
asin( 1.0) = +1.570796, 2*asin( 1.0)=+3.141593
asin(-0.5) = -0.523599, 6*asin(-0.5)=-3.141593
asin(0.0) = 0.000000, asin(-0.0)=-0.000000
asin(1.1) = nan
errno == EDOM: Numerical argument out of domain
FE_INVALID raised[edit] References
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4