【PHP8.x】abs関数の使い方

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * 計算処理の「設計図」を定義する抽象クラス。
7 * abstract キーワードが付いているため、このクラスから直接インスタンスは生成できません。
8 * このクラスを継承する子クラスは、定義された抽象メソッドを必ず実装する必要があります。
9 */
10abstract class Calculator
11{
12    /**
13     * 計算処理の「ルール」のみを定義する抽象メソッド。
14     * 具体的な処理内容は、このクラスを継承する子クラスで実装することが強制されます。
15     *
16     * @param int|float $num 計算対象の数値
17     * @return int|float 計算結果
18     */
19    abstract public function calculate(int|float $num): int|float;
20}
21
22/**
23 * Calculator 抽象クラスを継承した具象クラス。
24 * 絶対値を計算する具体的な処理を実装します。
25 */
26class AbsoluteValueCalculator extends Calculator
27{
28    /**
29     * 与えられた数値の絶対値を計算して返します。
30     *
31     * @param int|float $num 計算対象の数値
32     * @return int|float 計算結果の絶対値
33     */
34    public function calculate(int|float $num): int|float
35    {
36        // PHPの組み込み関数 abs() を使い、数値の絶対値 (absolute value) を返します。
37        return abs($num);
38    }
39}
40
41// 具象クラスのインスタンスを生成します。
42$calculator = new AbsoluteValueCalculator();
43
44// メソッドを呼び出して、負の数の絶対値を取得します。
45$inputNumber = -99.9;
46$result = $calculator->calculate($inputNumber);
47
48// 結果を出力します。
49echo "入力値: " . $inputNumber . PHP_EOL;
50echo "計算結果 (絶対値): " . $result . PHP_EOL;
51
52?>

このコードは、PHPのabstractキーワードを用いた抽象クラスと、組み込み関数abs()を使って数値の絶対値を計算する例です。

まず、Calculatorというabstractクラスは、計算処理の「設計図」を定義します。abstractが付いているため、このクラスから直接インスタンスを生成することはできません。また、abstractメソッドであるcalculateは、具体的な処理内容を持たず、このクラスを継承する子クラスが必ず実装しなければならないルールを定めます。これにより、様々な計算処理を統一的なインターフェースで扱えるようになります。

次に、AbsoluteValueCalculatorクラスはCalculator抽象クラスを継承し、calculateメソッドを具体的に実装しています。このメソッド内でPHPの組み込み関数abs()が使用されています。abs()関数は、引数 $num として渡されたintまたはfloat型の数値の絶対値を計算し、その結果をintまたはfloat型で返します。例えば、-99.9という負の数を渡すと、その絶対値である99.9が返されます。

最後に、AbsoluteValueCalculatorクラスのインスタンスを生成し、calculateメソッドを呼び出すことで、入力値-99.9の絶対値99.9を計算し、結果を出力しています。

Copy
1<?php
2
3declare(strict_types=1); // 厳格な型チェックを有効にする
4
5/**
6 * 数値処理を行うインターフェースの定義。
7 *
8 * このインターフェースは、数値を何らかの方法で処理するすべてのクラスが
9 * 従うべき「契約」を定めます。
10 * キーワード「interface」に対応しています。
11 */
12interface NumericProcessorInterface
13{
14    /**
15     * 与えられた数値を処理し、結果の数値を返します。
16     *
17     * @param int|float $number 処理対象の数値
18     * @return int|float 処理後の数値
19     */
20    public function process(int|float $number): int|float;
21}
22
23/**
24 * NumericProcessorInterface を実装し、数値の絶対値を計算するクラス。
25 *
26 * このクラスは、インターフェースで定義された `process` メソッドを実装し、
27 * その中で `abs()` 関数を使って数値の絶対値を計算します。
28 * これにより、キーワード「abs」と「interface」を関連付けています。
29 *
30 * もし複数の数値プロセッサに共通のロジックや状態が必要な場合は、
31 * `abstract` (抽象) クラスを導入し、このクラスがその抽象クラスを継承する
32 * 形にすることで、より柔軟な設計が可能です。
33 */
34final class AbsoluteValueProcessor implements NumericProcessorInterface
35{
36    /**
37     * 数値の絶対値を計算して返します。
38     *
39     * @param int|float $number 絶対値を計算する数値
40     * @return int|float 入力数値の絶対値
41     */
42    public function process(int|float $number): int|float
43    {
44        // PHP の組み込み関数 abs() を使用して絶対値を計算します。
45        // 例えば、-10.5 の絶対値は 10.5 になります。
46        return abs($number);
47    }
48}
49
50// サンプルコードの実行部分
51// AbsoluteValueProcessor クラスのインスタンスを作成します。
52$processor = new AbsoluteValueProcessor();
53
54// 異なる数値で processor を使って絶対値を計算し、結果を表示します。
55$numbersToProcess = [-5, 10.5, 0, -3.14];
56
57foreach ($numbersToProcess as $num) {
58    $absoluteValue = $processor->process($num);
59    echo "数値 {$num} の絶対値: {$absoluteValue}\n";
60}

このPHPコードは、与えられた数値の絶対値を計算するabs()関数の使用方法と、interface（インターフェース）を用いたオブジェクト指向の設計原則を示しています。

abs()関数は、引数として渡された整数（int）または浮動小数点数（float）の絶対値を返すPHPの組み込み関数です。絶対値とは、数値の符号を取り除いた正の値のことで、例えば-5の絶対値は5、10.5の絶対値は10.5となります。戻り値も入力と同じく整数または浮動小数点数となります。

コード中のNumericProcessorInterfaceは、数値を処理するクラスが実装すべきprocessメソッドを定義する「契約」です。これにより、どのようなクラスでもこのインターフェースを実装すれば、processメソッドを通じて一貫した方法で数値を処理できることを保証します。AbsoluteValueProcessorクラスは、このインターフェースを実装し、processメソッドの中でabs()関数を使って数値の絶対値を計算しています。

もし複数の処理クラスに共通のロジックや状態が必要な場合は、abstract（抽象）クラスを導入することで、コードの共通化と柔軟な設計が可能になります。このサンプルコードは、基本的な数値計算と、プログラムの拡張性を高めるオブジェクト指向の基礎を示しています。