【PHP8.x】YESSTR定数の使い方

Copy
1<?php
2
3// PHPの組み込み定数には 'YESSTR' は存在しません。
4// ここでは、提供されたリファレンス情報に基づき、'YESSTR' が何らかのPHP拡張機能によって定義される
5// 肯定的な意味を持つ定数であると仮定します。
6// 通常、このような定数は `define()` で定義されるのではなく、PHPのC言語レベルで定義されます。
7
8// サンプルコードを単体で動作させるため、'YESSTR' が未定義の場合に仮の値を定義します。
9if (!defined('YESSTR')) {
10    define('YESSTR', 'YES'); // 'YESSTR' が「はい」を意味する文字列定数であると仮定
11}
12
13/**
14 * 特定の条件が満たされた場合に数値を四捨五入する関数。
15 *
16 * システムエンジニアを目指す初心者の方へ：
17 * この関数は、何らかの処理結果（例えば `YESSTR` で示される「肯定」の状況）に応じて、
18 * 数値の四捨五入（キーワード「ししゃ」に関連）を行う例です。
19 * 定数 `YESSTR` の値自体は変更できませんが、プログラム内でその値を参照して利用できます。
20 *
21 * @param float $value 処理対象の数値。
22 * @param string $conditionStr 処理を実行するかの条件を示す文字列定数。`YESSTR` との比較を想定。
23 * @param int $precision 四捨五入する小数点以下の桁数。デフォルトは0（整数に四捨五入）。
24 * @return float 処理結果の数値。条件が一致しない場合は元の値が返されます。
25 */
26function processValueWithConditionalRounding(float $value, string $conditionStr, int $precision = 0): float
27{
28    // 提供された定数 'YESSTR' の値と引数で渡された条件文字列を比較します。
29    // もし条件文字列が 'YESSTR' の値と一致すれば、四捨五入処理を行います。
30    if ($conditionStr === YESSTR) {
31        // PHPの `round()` 関数を使用して数値を四捨五入します。
32        // `$precision` で小数点以下の桁数を指定できます。
33        return round($value, $precision);
34    } else {
35        // 条件が 'YESSTR' と一致しない場合は、元の数値をそのまま返します。
36        return $value;
37    }
38}
39
40// サンプル使用例
41$sampleNumber = 123.456;
42
43echo "元の数値: " . $sampleNumber . PHP_EOL;
44
45// 条件が 'YESSTR' と一致する場合の四捨五入（小数点以下2桁）
46$resultRounded = processValueWithConditionalRounding($sampleNumber, YESSTR, 2);
47echo "YESSTR条件での四捨五入 (小数点以下2桁): " . $resultRounded . PHP_EOL; // 出力: 123.46
48
49// 条件が 'YESSTR' と一致する場合の四捨五入（整数に四捨五入）
50$resultInteger = processValueWithConditionalRounding($sampleNumber, YESSTR, 0);
51echo "YESSTR条件での四捨五入 (整数): " . $resultInteger . PHP_EOL; // 出力: 123
52
53// 条件が 'YESSTR' と一致しない場合（例: 'NO'）
54$resultNoChange = processValueWithConditionalRounding($sampleNumber, 'NO', 2);
55echo "NO条件での処理結果 (変化なし): " . $resultNoChange . PHP_EOL; // 出力: 123.456
56

PHPの YESSTR は、通常はPHPの拡張機能によって提供される、肯定的な意味を持つ定数です。このサンプルコードでは、YESSTR が未定義の場合に「YES」という文字列として仮定義し、その使い方を示しています。定数はプログラムの実行中に値を変更できない固定のデータであり、条件判断などで利用されます。

processValueWithConditionalRounding 関数は、与えられた数値 $value に対して、キーワード「ししゃ」に関連する四捨五入処理を行う関数です。この処理は、引数 $conditionStr の値が定数 YESSTR の値と一致する場合にのみ実行されます。引数 $precision は、四捨五入する小数点以下の桁数を指定し、0を設定すると整数に丸められます。関数が実行され、条件が YESSTR と一致すれば、四捨五入された数値が戻り値として返されます。もし条件が一致しなければ、数値は四捨五入されずに元の値がそのまま返されます。この例を通じて、定数を活用した条件分岐と、PHPの round() 関数を使った数値処理の基本を学ぶことができます。

Copy
1<?php
2
3/**
4 * 拡張定数 YESSTR を用いたPHPの四則演算の例を示す関数。
5 *
6 * この関数は、システムエンジニアを目指す初心者向けに、
7 * PHPの基本的な四則演算子と、拡張定数が数値コンテキストで
8 * どのように扱われるかを示します。
9 *
10 * リファレンス情報によると「YESSTR」は拡張定数であり、
11 * 通常はPHPの特定の拡張機能によって提供されます。
12 * そのため、このコードがPHP環境で単体で動作するよう、
13 * ここでは YESSTR が未定義の場合に仮の値を定義しています。
14 * 実際の拡張機能が提供する YESSTR の値は異なる場合があり、
15 * その型（文字列、真偽値、数値など）によって四則演算時の挙動が変わります。
16 * 例として、ここでは数値として 0 に変換される文字列 ('yes') を仮定します。
17 */
18function demonstrateArithmeticWithYesStr(): void
19{
20    // === 拡張定数 YESSTR の仮定義 ===
21    // 拡張機能によって提供される定数がない環境でもコードが動作するように、
22    // 未定義の場合のみ 'yes' という文字列値で定義します。
23    // PHPでは、非数値文字列が数値コンテキストで使用されると、通常 0 に型変換されます。
24    if (!defined('YESSTR')) {
25        define('YESSTR', 'yes'); // 例: 'yes' という文字列値を持つと仮定
26    }
27    // === 仮定義の終わり ===
28
29    echo "--- PHP 四則演算子と拡張定数 YESSTR の使用例 ---\n\n";
30
31    $numberA = 20;
32    $numberB = 5;
33
34    echo "現在の YESSTR の値: '" . YESSTR . "'\n";
35    // PHPにおける型変換: 非数値文字列（例: 'yes'）は数値コンテキストで 0 として扱われます。
36    echo "四則演算における YESSTR の数値としての振る舞い (例: 'yes'の場合): " . (int)YESSTR . "\n\n";
37
38    // 1. 足し算 (Addition: +)
39    // YESSTR が 'yes' (数値として0) と仮定されるため、20 + 0 = 20
40    $resultAdd = $numberA + YESSTR;
41    echo "{$numberA} + YESSTR = {$resultAdd}\n";
42
43    // 2. 引き算 (Subtraction: -)
44    $resultSub = $numberA - $numberB; // 20 - 5 = 15
45    echo "{$numberA} - {$numberB} = {$resultSub}\n";
46
47    // 3. 掛け算 (Multiplication: *)
48    // YESSTR が 'yes' (数値として0) と仮定されるため、20 * 0 = 0
49    $resultMul = $numberA * YESSTR;
50    echo "{$numberA} * YESSTR = {$resultMul}\n";
51
52    // 4. 割り算 (Division: /)
53    $resultDiv = $numberA / $numberB; // 20 / 5 = 4
54    echo "{$numberA} / {$numberB} = {$resultDiv}\n";
55
56    // 5. 剰余 (Modulus: %) - 整数のみに適用され、割り算の余りを返します。
57    $resultMod = $numberA % $numberB; // 20 % 5 = 0
58    echo "{$numberA} % {$numberB} = {$resultMod}\n";
59
60    echo "\n---------------------------------------------\n";
61    echo "補足:\n";
62    echo "PHPでは、数値以外の値が四則演算子で使われる際、\n";
63    echo "自動的に数値型に変換（型変換）されます。これは柔軟ですが、\n";
64    echo "意図しない結果を避けるために注意深く型を扱うことが重要です。\n";
65}
66
67// 関数を実行して、四則演算のデモンストレーションを開始します。
68demonstrateArithmeticWithYesStr();
69

このサンプルコードは、PHPの基本的な四則演算子の使い方と、拡張定数であるYESSTRを組み合わせた計算の例を、システムエンジニアを目指す初心者向けに紹介しています。YESSTRはPHPの特定の拡張機能によって提供される定数で、引数や戻り値はありません。この例では、拡張機能が利用できない環境でも動作するように、YESSTRが未定義の場合に一時的に'yes'という文字列値で定義しています。

PHPでは、足し算（+）、引き算（-）、掛け算（*）、割り算（/）、そして割り算の余りを求める剰余（%）といった四則演算子を使用します。これらの演算子を使う際に、数値以外の値（例えば、文字列の'yes'など）が渡されると、PHPは自動的にその値を数値に変換しようとします。これを「型変換」と呼びます。このコードのYESSTRのように、数値ではない文字列が数値コンテキストで使われると、通常は数値の0として扱われます。

サンプルコード内のdemonstrateArithmeticWithYesStr関数は、引数を一切取らず、処理結果として画面に計算内容を出力するだけで、特に値を返すことはありません。関数内部では、YESSTRが0として計算されることを示し、例えば「20 + YESSTR」は「20 + 0」と同じ結果の20となり、「20 * YESSTR」は「20 * 0」と同じ結果の0になる様子が確認できます。このようにPHPは柔軟な型変換を行いますが、意図しない結果を避けるためには、演算時に値がどのように変換されるかを理解しておくことが重要です。