PHP의 asin() 함수는 주어진 숫자에 대한 아크사인(arc sine, 역사인) 값을 라디안 단위로 반환합니다. 이 함수는 -1부터 1 사이 범위의 숫자만 입력받을 수 있으며, 그 범위를 벗어난 값이 전달되면 NAN(Not a Number)을 반환합니다.
문법(Syntax)
asin(num)
매개변수(Parameters)
num − 아크사인 값을 구하고자 하는 숫자입니다. 반드시 -1 이상 1 이하 범위 내의 값이어야 합니다.
반환값(Return Value)
입력된 숫자의 아크사인 값을 라디안(radian) 단위로 반환합니다. 만약 입력값이 -1에서 1 사이의 유효 범위를 벗어나면 NAN을 반환합니다.
예제 1
다음은 소수점 값을 사용한 기본적인 예제입니다.
<?php echo(asin(0.50) . "<br>"); echo(asin(-0.90) . "<br>"); ?>
출력 결과
0.5235987755983<br>-1.1197695149986<br>
예제 2
경계값과 범위를 벗어난 값을 함께 테스트해 보겠습니다.
<?php echo(asin(0) . "<br>"); echo(asin(1) . "<br>"); echo(asin(-1) . "<br>"); echo(asin(2) . "<br>"); ?>
출력 결과
0<br>1.5707963267949<br>-1.5707963267949<br>NAN<br>
참고 사항
위 결과에서 볼 수 있듯이, asin(1)은 π/2(약 1.5707963...)를 반환하며, asin(-1)은 -π/2를 반환합니다. 이는 삼각함수의 정의와 일치합니다. 반면 입력값으로 2처럼 유효 범위를 벗어난 값을 넣으면 NAN이 반환되므로, 실제 코드에서는 입력값 검증을 통해 이러한 경우를 처리하는 것이 좋습니다. 각도(degree) 단위가 필요한 경우에는 반환된 라디안 값에 rad2deg() 함수를 사용하여 변환할 수 있습니다.