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

Copy
1<?php
2
3/**
4 * PHPのcos()関数の基本的な使い方を示すサンプルコードです。
5 *
6 * このコードは、異なるラジアン値に対するコサイン値を計算し、その結果を表示します。
7 * また、度数からラジアンへの変換方法も示しており、
8 * 数学関数を学ぶシステムエンジニア初心者にとって、
9 * 「PHPの数学関数の使い方をまとめた小冊子」の一ページのような、
10 * 基本的で分かりやすい情報提供を意図しています。
11 */
12function demonstrate_cos_function(): void
13{
14    echo "--- PHP cos() 関数の使用例 ---\n";
15
16    // 1. 基本的なコサイン計算（60度 = π/3 ラジアン）
17    // cos()関数は引数としてラジアン値を期待します。
18    $angle_radian_1 = M_PI / 3; // M_PIはPHPに定義されている円周率πの定数
19    $cosine_value_1 = cos($angle_radian_1);
20    echo "角度 " . round(rad2deg($angle_radian_1)) . "度 (" . round($angle_radian_1, 2) . " ラジアン) のコサイン値: " . round($cosine_value_1, 4) . " (期待値: 0.5)\n";
21
22    // 2. 別の角度でのコサイン計算（180度 = π ラジアン）
23    $angle_radian_2 = M_PI;
24    $cosine_value_2 = cos($angle_radian_2);
25    echo "角度 " . round(rad2deg($angle_radian_2)) . "度 (" . round($angle_radian_2, 2) . " ラジアン) のコサイン値: " . round($cosine_value_2, 4) . " (期待値: -1.0)\n";
26
27    // 3. 度数をラジアンに変換してコサインを計算する例（45度）
28    // deg2rad()関数を使って度数をラジアンに変換できます。
29    $angle_degree_3 = 45; // 45度
30    $angle_radian_3 = deg2rad($angle_degree_3);
31    $cosine_value_3 = cos($angle_radian_3);
32    echo "角度 " . $angle_degree_3 . "度 (" . round($angle_radian_3, 2) . " ラジアン) のコサイン値: " . round($cosine_value_3, 4) . " (期待値: 約 0.7071)\n";
33
34    echo "---------------------------------\n";
35    echo "補足: PHPの数学関数は、三角関数などの引数にラジアン値を求めます。\n";
36    echo "度数を使用する場合は、deg2rad() 関数でラジアンに変換してください。\n";
37}
38
39// 定義した関数を実行します。
40demonstrate_cos_function();

PHPのcos()関数は、与えられた角度のコサイン（余弦）を計算するための数学関数です。この関数は、引数としてラジアン単位の浮動小数点数（float）を受け取り、その角度のコサイン値を浮動小数点数（float）で返します。

提供されたサンプルコードは、システムエンジニアを目指す初心者の方にも理解しやすいよう、cos()関数の基本的な使用方法を示しています。コード内では、まずM_PI定数を利用して60度（π/3ラジアン）や180度（πラジアン）といった具体的なラジアン値のコサインを計算する例が紹介されています。さらに、度数表記の角度（例：45度）をdeg2rad()関数でラジアンに変換し、その後cos()関数でコサインを求める実践的な方法も示されています。

これにより、PHPの数学関数、特に三角関数は引数としてラジアン値を要求するという重要な点を学ぶことができます。このサンプルコードの説明は、「PHPの数学関数の使い方をまとめた小冊子」の一ページのように、必要な情報を簡潔かつ正確に提供することを意図しています。PHPで三角関数を扱う際は、常に引数がラジアン単位であることを意識して利用してください。

Copy
1<?php
2
3/**
4 * cos() 関数は、引数として与えられた角度（ラジアン）のコサイン（余弦）を計算します。
5 * システムエンジニアにとって、物理学、グラフィックス、信号処理など、
6 * 様々な計算で数学関数が必要になることがあります。
7 *
8 * @param float $num コサインを計算する角度をラジアン単位で指定します。
9 *                    度数からラジアンへの変換は $degrees * (M_PI / 180) で行えます。
10 * @return float 指定された角度のコサイン値。-1.0 から 1.0 の範囲の浮動小数点数です。
11 */
12
13// 例1: 0ラジアン (0度) のコサインを計算
14// 0度のコサインは 1 です。
15$angleRad1 = 0.0;
16$cosine1 = cos($angleRad1);
17echo "角度 (ラジアン): " . $angleRad1 . " (0度)" . PHP_EOL;
18echo "コサイン: " . $cosine1 . PHP_EOL;
19echo PHP_EOL;
20
21// 例2: M_PI / 2 ラジアン (90度) のコサインを計算
22// 90度のコサインは 0 です。
23// M_PI は PHP の組み込み定数で円周率 π を表します。
24$angleRad2 = M_PI / 2;
25$cosine2 = cos($angleRad2);
26echo "角度 (ラジアン): " . $angleRad2 . " (90度)" . PHP_EOL;
27echo "コサイン: " . $cosine2 . PHP_EOL;
28echo PHP_EOL;
29
30// 例3: M_PI ラジアン (180度) のコサインを計算
31// 180度のコサインは -1 です。
32$angleRad3 = M_PI;
33$cosine3 = cos($angleRad3);
34echo "角度 (ラジアン): " . $angleRad3 . " (180度)" . PHP_EOL;
35echo "コサイン: " . $cosine3 . PHP_EOL;
36echo PHP_EOL;
37
38// 例4: 度数をラジアンに変換してコサインを計算 (60度の場合)
39$angleDegrees4 = 60.0;
40$angleRad4 = deg2rad($angleDegrees4); // deg2rad() 関数で度数からラジアンへ変換
41$cosine4 = cos($angleRad4);
42echo "角度 (度数): " . $angleDegrees4 . PHP_EOL;
43echo "角度 (ラジアン): " . $angleRad4 . PHP_EOL;
44echo "コサイン: " . $cosine4 . PHP_EOL;
45
46?>

PHPのcos()関数は、引数として与えられた角度（ラジアン単位）のコサイン（余弦）を計算するための機能です。システムエンジニアとして物理演算、グラフィックス、信号処理など、様々な数値計算が必要な場面で利用されます。

この関数は、コサインを計算したい角度をfloat $numとしてラジアン単位で受け取ります。例えば、0ラジアン（0度）はコサインが1、M_PI / 2ラジアン（90度）はコサインが0、M_PIラジアン（180度）はコサインが-1となります。ここでM_PIはPHPに組み込まれている円周率の定数です。戻り値はfloat型で、計算されたコサイン値が返され、その値は常に-1.0から1.0の範囲に収まります。

サンプルコードでは、これらの基本的な角度におけるコサイン値の計算例を示しています。また、度数で角度を指定したい場合には、deg2rad()関数を使用することで、度数からラジアンへの変換を簡単に行い、cos()関数に渡すことができます。このように、cos()関数は数学的な問題をPHPで解決する際に役立つ基本的なツールの一つです。