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

acos()関数の定義と使い方

acos()関数は、引数として渡した数値の逆余弦（アークコサイン）をラジアン単位で返す関数です。acos()はcos()関数の逆関数にあたり、cos(x)=y が成り立つとき、acos(y)=x となります。

例えば、cos(pi/2)=0 であり、acos(0)=1.57079633ラジアン（pi/2に相当）となります。

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

構文

acos ( float $arg ) : float

パラメータ

戻り値

PHPのacos()関数は、指定した数値の逆余弦を返します。戻り値はラジアンで表された角度です。

なお、引数が-1〜1の範囲外の場合はNAN（Not a Number）が返されます。

対応するPHPバージョン

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

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

次の例ではacos(0.5)を計算し、pi/3に相当する1.04719755ラジアンを返します。

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

出力結果

acos(0.5) = 1.0471975511966 radians

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

次の例ではacos(0)を計算し、pi/2に相当する1.5707963267949ラジアンを返します。

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

出力結果

acos(0) = 1.5707963267949 radians

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

次の例ではacos(-1)を計算します。結果は3.14159265ラジアン（piに相当）です。

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

出力結果

acos(-1) = 3.1415926535898 radians

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

引数が-1〜1の範囲外の場合、この関数はNANを返します。次の例では引数に5を指定しています。

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

出力結果

acos(5) = NAN radians

まとめ

acos()関数は、cos()関数の逆関数として逆余弦をラジアンで求めるための関数です。引数は必ず-1〜1の範囲で指定し、範囲外の値を渡すとNANが返される点に注意しましょう。三角関数を使った角度計算などで活用できます。