関数の概要
PHPの acos 関数は、与えられた値の逆余弦(アークコサイン)をラジアン単位で返します。逆余弦は、余弦関数の逆関数であり、主に三角関数の計算や角度の求め方に使われます。数学や物理シミュレーションなど数値処理の場面でよく利用される関数です。
パラメータの説明
float $arg:逆余弦を求めたい値を指定します。この値は必ず-1以上1以下の範囲でなければなりません。
戻り値
関数は指定された引数の逆余弦をラジアンで返します。返される角度の範囲は 0 から π(約3.14159)の間です。もし引数が範囲外の場合は、NaN(非数)を返します。
使用例
基本的な使い方
<?php
// 1の逆余弦は0ラジアン
$result = acos(1);
echo $result; // 0
?>
この例では、1の逆余弦を求めています。余弦が1になる角度は0ラジアン(0度)なので、0が出力されます。
異なる値の逆余弦を計算
<?php
// 0の逆余弦はπ/2ラジアン(90度)
echo acos(0); // 1.5707963267949
// -1の逆余弦はπラジアン(180度)
echo acos(-1); // 3.1415926535898
?>
0の逆余弦はラジアンでπ/2、-1の逆余弦はπラジアンとなります。これらは典型的な角度の値として覚えておくと便利です。
無効な値を指定した場合の挙動
<?php
// 範囲外の引数
$result = acos(2);
var_dump($result); // float(NAN)
?>
acos関数に範囲外の値を指定すると、結果は NaN(非数)となり計算できません。入力値の範囲チェックは必須です。
関連する関数
cos: コサイン値を計算する関数asin: 逆正弦(アークサイン)を計算する関数atan: 逆正接(アークタンジェント)を計算する関数deg2rad: 度をラジアンに変換する関数rad2deg: ラジアンを度に変換する関数
まとめ
acos はPHPの標準関数で、数値の逆余弦をラジアン単位で求める際に使います。値の範囲は必ず -1 から 1 の間に限定し、範囲外の場合は NaN が返るため注意が必要です。三角関数や角度計算が必要な場面で実務的に便利に使える関数です。
