PHPのasin()関数の使い方を徹底解説！逆正弦（アークサイン）の計算方法

asin()関数とは？定義と使い方

PHPのasin()関数は、引数（arg）の逆正弦（アークサイン）をラジアン単位で返す関数です。asin()はsin()関数の逆関数にあたります。つまり、sin(x) = y が成り立つとき、asin(y) = x となります。

例えば、sin(π/2) = 1 であるため、asin(1) を計算すると 1.57079633 ラジアン（π/2 に相当）が返されます。

この関数の戻り値はfloat型（浮動小数点数）です。

構文

asin ( float $arg ) : float

パラメータ

戻り値

PHPのasin()関数は、指定された数値の逆正弦（アークサイン）を返します。戻り値はラジアン単位の角度として表されます。

対応するPHPバージョン

この関数は、PHP 4.x、PHP 5.x、PHP 7.x のすべてのバージョンで利用可能です。

使用例1：asin(0.5) の計算

次の例では、asin(0.5) を計算します。結果は 0.5235987755983 ラジアンとなり、これは π/6 に相当します。

<?php
   $arg=0.5;
   $val=asin($arg);
   echo "asin(" . $arg . ") = " . $val . " radians";
?>

出力結果

asin(0.5) = 0.5235987755983 radians

使用例2：asin(0) の計算

次の例では、asin(0) を計算します。sin(0) = 0 であるため、結果は 0 ラジアンとなります。

<?php
   $arg=0;
   $val=asin($arg);
   echo "asin(" . $arg . ") = " . $val . " radians";
?>

出力結果

asin(0) = 0 radians

使用例3：asin(-1) の計算

次の例では、asin(-1) を計算します。結果は -1.5707963267949 ラジアン（-π/2 に相当）となります。

<?php
   $arg=-1;
   $val=asin($arg);
   echo "asin(" . $arg . ") = " . $val . " radians";
?>

出力結果

asin(-1) = -1.5707963267949 radians

使用例4：範囲外の値を指定した場合

次の例では、引数として -1 から 1 の範囲外の値（5）を指定しています。この場合、結果は NAN（Not A Number）となります。

<?php
   $arg=5;
   $val=asin($arg);
   echo "asin(" . $arg . ") = " . $val . " radians";
?>

出力結果

asin(5) = NAN radians

まとめ

PHPのasin()関数は、sin()関数の逆関数として動作し、-1 から 1 の範囲の数値に対する逆正弦をラジアン単位で返します。範囲外の値を渡すと NAN が返されるため、実装時には引数の範囲チェックを適切に行うことが重要です。三角関数を使った数学的計算や座標変換などの処理で活用できる便利な関数です。