asin

関数の概要

PHPの asin 関数は、逆正弦関数（アークサイン）を計算します。引数として与えられた値の逆正弦の角度（ラジアン単位）を返します。これは、入力値が正弦値から元の角度を求める場合に使われます。

パラメータの説明

  • float $arg – 逆正弦を求めたい値。範囲は -1 から 1 までの実数です。

戻り値

引数の逆正弦の角度をラジアン単位で返します。返される値の範囲は -π/2 から π/2 までです。引数が範囲外の場合、PHPは警告を出し、結果は NaN（非数）になります。

使用例

基本的な使い方

<?php
// 0.5 の逆正弦を計算
$result = asin(0.5);
echo $result; // 約0.5235987755983（ラジアン）
?>

この例では、0.5の逆正弦を求めており、値は約0.524ラジアン（30度）となります。

角度に変換して出力する

<?php
// asinの結果を度数に変換する関数
function rad2deg($rad) {
    return $rad * (180 / M_PI);
}

$value = 1;
$angleRad = asin($value);
$angleDeg = rad2deg($angleRad);
echo $angleDeg; // 90
?>

ここでは、asinの結果を度数に変換し、90度と表示しています。PHPの M_PI は円周率の定数です。

範囲外の値を渡した場合の挙動

<?php
$result = asin(2); // 範囲外の入力
var_dump($result); // float(NAN)
?>

引数が -1 から 1 を超える場合、結果は NaN（非数）となります。エラーを避けたい場合は、範囲チェックを入れましょう。

関連する関数

  • sin – 正弦を計算する関数
  • acos – 逆余弦（アークコサイン）を計算する関数
  • atan – 逆正接（アークタンジェント）を計算する関数
  • deg2rad – 度をラジアンに変換する関数
  • rad2deg – ラジアンを度に変換する関数（ユーザー定義例も多い）

まとめ

PHPの asin 関数は、指定した値の逆正弦（アークサイン）を求める基本的な数学関数です。角度はラジアンで返されるため、度数に変換したい場合は工夫が必要です。また、入力値は必ず -1 から 1 の範囲内で指定することが重要です。実務でも数値の角度操作が必要な場面で有用なので、正しく使いこなしましょう。

スポンサーリンク