【PHP8.x】sinh()関数の使い方

Copy
1<?php
2
3declare(strict_types=1);
4
5namespace App\Utils;
6
7/**
8 * 双曲線正弦関数を利用したユーティリティクラス
9 */
10class HyperbolicSineUtil
11{
12    /**
13     * 指定された数値の双曲線正弦を計算します。
14     *
15     * @param float $num 計算対象の数値
16     * @return float 計算結果の双曲線正弦
17     */
18    public static function calculateSinh(float $num): float
19    {
20        // sinh関数を使用して双曲線正弦を計算
21        return sinh($num);
22    }
23}
24
25// 使用例
26$number = 2.5;
27$sinhValue = HyperbolicSineUtil::calculateSinh($number);
28echo "sinh({$number}) = {$sinhValue}" . PHP_EOL; // sinh(2.5) = 6.0502045102731

PHPのsinh関数は、指定された数値の双曲線正弦（ハイパボリックサイン）を計算するために使用されます。この関数は、float型の引数$numを受け取り、同じくfloat型の結果を返します。双曲線正弦は、数学や物理学でよく利用される関数で、sinh(x) = (e^x - e^-x) / 2という式で定義されます。

サンプルコードでは、App\Utils\HyperbolicSineUtilクラス内に、calculateSinhという静的メソッドを定義し、このメソッド内でsinh関数を利用しています。calculateSinhメソッドは、float型の引数$numを受け取り、その双曲線正弦を計算して返します。

具体例として、サンプルコードでは$numberに2.5を代入し、HyperbolicSineUtil::calculateSinh(2.5)を呼び出すことで、2.5の双曲線正弦を計算しています。計算結果は$sinhValueに格納され、echo文によってsinh(2.5) = 6.0502045102731のように出力されます。

このように、sinh関数は、与えられた数値に対する双曲線正弦の値を簡単に取得することができる便利な関数です。数学的な計算や、特定の物理現象のシミュレーションなど、様々な場面で利用できます。

Copy
1<?php
2
3/**
4 * sinh() 関数の使い方を示すサンプルコードです。
5 *
6 * この関数は、引数として与えられた数値のハイパーボリックサイン（双曲線正弦）を計算します。
7 * 数学的な計算が必要な場合に利用されます。
8 */
9function demonstrateSinhFunction(): void
10{
11    // さまざまな浮動小数点数を定義
12    $number1 = 0.0;
13    $number2 = 1.0;
14    $number3 = 2.5;
15    $number4 = -0.5;
16
17    // sinh() 関数を使用して、各数値のハイパーボリックサインを計算します。
18    // 結果は浮動小数点数（float）として返されます。
19    $result1 = sinh($number1);
20    $result2 = sinh($number2);
21    $result3 = sinh($number3);
22    $result4 = sinh($number4);
23
24    // 計算結果を画面に出力して確認します。
25    // PHP_EOL はOSに応じた改行コードを出力します。
26    echo "sinh({$number1}) = {$result1}" . PHP_EOL;
27    echo "sinh({$number2}) = {$result2}" . PHP_EOL;
28    echo "sinh({$number3}) = {$result3}" . PHP_EOL;
29    echo "sinh({$number4}) = {$result4}" . PHP_EOL;
30}
31
32// 定義した関数を実行し、sinh() 関数の動作を示します。
33demonstrateSinhFunction();

PHP 8で提供されるsinh()関数は、数学的な計算を行うための拡張機能の一つです。この関数は、引数として与えられた数値のハイパーボリックサイン（双曲線正弦）を計算し、その結果を浮動小数点数（float）として返します。

引数にはfloat $numを指定し、ハイパーボリックサインを求めたい数値を渡します。戻り値は常にfloat型となり、計算後のハイパーボリックサインの値が得られます。

サンプルコードでは、demonstrateSinhFunctionという関数内でsinh()関数の具体的な使い方を示しています。まず、$number1から$number4として、0.0, 1.0, 2.5, -0.5といった異なる浮動小数点数を準備しています。それぞれの数値に対してsinh()関数を呼び出すことで、ハイパーボリックサインを計算し、結果を$result1から$result4に格納しています。最後に、echo文とPHP_EOLを使用して、それぞれの計算結果を画面に分かりやすく出力しています。これにより、sinh(0.0) = 0.0のように、元の数値と計算結果がどのように対応するのかを確認できます。この関数は、科学技術計算や統計処理など、特定の数学的要件があるアプリケーション開発で利用されます。