asin-asinf-asinl.md

title	ms.custom	ms.date	ms.reviewer	ms.suite	ms.technology	ms.tgt_pltfrm	ms.topic	apiname	apilocation	apitype	f1_keywords	dev_langs	helpviewer_keywords	ms.assetid	caps.latest.revision	author	ms.author	manager
asin, asinf, asinl | Microsoft Docs		11/04/2016			cpp-standard-libraries		article	asinf asinl asin	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-math-l1-1-0.dll	DLLExport	asin asinl asinf	C++	asin function asinl function asinf function trigonometric functions arcsine function	ca05f9ea-b711-49f6-9f32-2f4019abfd69	14	corob-msft	corob	ghogen

asin, asinf, asinl

Calculates the arcsine.

Syntax

double asin(   
   double x   
);  
float asin(  
   float x  
);  // C++ only  
long double asin(  
   long double x  
);  // C++ only  
float asinf (   
   float x   
);  
long double asinl(  
   long double x  
);  

Parameters

x
Value whose arcsine is to be calculated.

Return Value

The asin function returns the arcsine (the inverse sine function) of x in the range -π/2 to π/2 radians.

By default, if x is less than -1 or greater than 1, asin returns an indefinite.

Input	SEH Exception	Matherr Exception
± ∞	INVALID	_DOMAIN
± QNAN,IND	none	_DOMAIN
|x|>1	INVALID	_DOMAIN

Remarks

Because C++ allows overloading, you can call overloads of asin with float and long double values. In a C program, asin always takes and returns a double.

Requirements

Routine	Required header
asin, asinf, asinl	<math.h>

Example

For more information, see acos, acosf, acosl.

See Also

Floating-Point Support
acos, acosf, acosl
atan, atanf, atanl, atan2, atan2f, atan2l
cos, cosf, cosl, cosh, coshf, coshl
_matherr
sin, sinf, sinl, sinh, sinhf, sinhl
tan, tanf, tanl, tanh, tanhf, tanhl