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

Copy
1<?php
2
3/**
4 * 文字列を指定した区切り文字で分割するサンプルコード.
5 *
6 * @param string $string 分割対象の文字列
7 * @param string $delimiter 区切り文字
8 * @return array 分割された文字列の配列
9 */
10function explode_example(string $string, string $delimiter): array
11{
12  // explode関数を使って文字列を分割します.
13  $exploded_array = explode($delimiter, $string);
14
15  // 分割された配列を返します.
16  return $exploded_array;
17}
18
19// 使用例
20$string = "apple,banana,orange";
21$delimiter = ",";
22$result = explode_example($string, $delimiter);
23
24// 結果の表示
25print_r($result);
26
27?>

このPHPサンプルコードは、explode関数を使用して文字列を指定した区切り文字で分割する方法を示しています。explode関数は、第一引数に区切り文字、第二引数に分割対象の文字列を受け取り、分割された文字列を配列として返します。

サンプルコードでは、explode_exampleという関数を定義しています。この関数は、分割対象の文字列 $string と区切り文字 $delimiter を引数として受け取ります。関数内では、explode関数を用いて $string を $delimiter で分割し、その結果を $exploded_array という配列に格納します。最後に、分割された文字列が格納された配列 $exploded_array を返します。

使用例では、$string に "apple,banana,orange" という文字列、$delimiter に ","（カンマ）という区切り文字を定義し、explode_example 関数に渡しています。explode関数は、このカンマを区切り文字として文字列を分割し、"apple"、"banana"、"orange" を要素とする配列を返します。print_r 関数を使って、分割された配列の内容を表示しています。このコードを実行すると、配列の内容が画面に出力されます。explode関数は、文字列処理において非常に便利な関数であり、CSVファイルの解析や、URLの分解など、様々な場面で利用できます。

Copy
1<?php
2
3/**
4 * 文字列を指定した区切り文字で分割するサンプルコード
5 */
6$string = "apple,banana,orange";
7$delimiter = ",";
8
9// explode関数を使って文字列を分割
10$array = explode($delimiter, $string);
11
12// 分割された配列の要素を順番に出力
13foreach ($array as $item) {
14    echo $item . PHP_EOL;
15}
16
17?>

このサンプルコードは、PHPのexplode関数を使って文字列を分割する方法を示しています。explode関数は、指定された区切り文字に基づいて文字列を配列に分割する際に使用します。

この例では、$string変数に"apple,banana,orange"という文字列が格納されており、$delimiter変数には区切り文字として","（カンマ）が設定されています。explode($delimiter, $string)を実行することで、$stringがカンマで区切られ、結果として$array変数には"apple"、"banana"、"orange"という3つの要素を持つ配列が格納されます。

explode関数の第一引数には区切り文字（ここではカンマ）、第二引数には分割対象の文字列を指定します。explode関数の戻り値は、分割された文字列の配列です。

その後、foreachループを使って$array配列の各要素を順番に出力しています。PHP_EOLは改行コードを表し、各要素が改行されて表示されます。このコードを実行すると、"apple"、"banana"、"orange"がそれぞれ別の行に出力されます。explode関数は、CSVファイルの解析や、特定の区切り文字で区切られたデータを処理する際によく利用されます。

Copy
1<?php
2
3/**
4 * 指定された区切り文字で文字列を分割し、複数の部分文字列の配列を返します。
5 *
6 * システムエンジニアを目指す初心者向けのポイント:
7 * - `explode()` 関数は、文字列を指定した区切り文字（デリミタ）で「複数の」部分に分割し、
8 *   その結果を配列として返します。これが「複数」というキーワードの最も基本的な意味です。
9 * - 例えば、「りんご,バナナ,みかん」という文字列をカンマで分割すると、
10 *   ['りんご', 'バナナ', 'みかん'] という3つの要素からなる配列が得られます。
11 * - 第3引数 `$limit` を使うことで、分割する部分の最大数を制御できます。
12 *   これにより、意図的に特定の数の「複数」の要素を得たり、残りの部分を一つの要素として扱ったりできます。
13 *
14 * @param string $delimiter 分割に使用する区切り文字。例: ',' や '-'。
15 *                          PHP 8では空文字列を渡すとValueErrorが発生します。
16 * @param string $string 分割対象の文字列。
17 *                        PHP 8ではnullを渡すとTypeErrorが発生します。
18 * @param int $limit [オプション] 返される配列要素の最大数。
19 *                    - 正の数: 最大でその数まで分割し、最後の要素には残りの文字列がすべて含まれます。
20 *                    - 負の数: 最後からその数だけ要素を除外して返します。
21 *                    - 0: 1つだけ要素を含む配列を返します。
22 *                    デフォルトはPHP_INT_MAX（ほぼ無限）。
23 * @return array 分割された部分文字列の配列。
24 */
25function splitStringIntoMultipleParts(string $delimiter, string $string, int $limit = PHP_INT_MAX): array
26{
27    return explode($delimiter, $string, $limit);
28}
29
30// --- サンプルコードの実行例 ---
31
32echo "--- 1. 基本的な文字列の分割 (複数の要素) ---\n";
33$data1 = "apple,banana,cherry,date";
34$parts1 = splitStringIntoMultipleParts(",", $data1);
35echo "元の文字列: '" . $data1 . "'\n";
36echo "区切り文字: ','\n";
37echo "結果の配列: [";
38echo implode(", ", array_map(fn($p) => "'".$p."'", $parts1)); // PHP 8の矢印関数fnを使用
39echo "]\n";
40echo "=> " . count($parts1) . "個の要素 (複数の要素が生成されます)\n\n";
41
42echo "--- 2. limit 引数を使った分割 (部分数の制御) ---\n";
43$data2 = "red-green-blue-yellow-orange";
44
45// limit = 3: 最大3つの部分に分割。最後の要素に残りの全てが含まれます。
46$parts2_limit3 = splitStringIntoMultipleParts("-", $data2, 3);
47echo "元の文字列: '" . $data2 . "'\n";
48echo "区切り文字: '-', limit=3\n";
49echo "結果の配列: [";
50echo implode(", ", array_map(fn($p) => "'".$p."'", $parts2_limit3));
51echo "]\n";
52echo "=> " . count($parts2_limit3) . "個の要素\n\n";
53
54// limit = -1: 最後から1つの要素を除外して分割します。
55$parts2_limit_negative1 = splitStringIntoMultipleParts("-", $data2, -1);
56echo "元の文字列: '" . $data2 . "'\n";
57echo "区切り文字: '-', limit=-1\n";
58echo "結果の配列: [";
59echo implode(", ", array_map(fn($p) => "'".$p."'", $parts2_limit_negative1));
60echo "]\n";
61echo "=> " . count($parts2_limit_negative1) . "個の要素 (最後の要素が除外された複数の要素)\n\n";
62
63echo "--- 3. 区切り文字が見つからない場合 ---\n";
64$data3 = "singleword";
65$parts3 = splitStringIntoMultipleParts(",", $data3);
66echo "元の文字列: '" . $data3 . "'\n";
67echo "区切り文字: ','\n";
68echo "結果の配列: [";
69echo implode(", ", array_map(fn($p) => "'".$p."'", $parts3));
70echo "]\n";
71echo "=> " . count($parts3) . "個の要素 (区切り文字がない場合は、元の文字列がそのまま1つの要素として含まれます)\n\n";
72
73echo "--- 4. 空の文字列を分割する場合 ---\n";
74$data4 = "";
75$parts4 = splitStringIntoMultipleParts(",", $data4);
76echo "元の文字列: '" . $data4 . "'\n";
77echo "区切り文字: ','\n";
78echo "結果の配列: [";
79echo implode(", ", array_map(fn($p) => "'".$p."'", $parts4));
80echo "]\n";
81echo "=> " . count($parts4) . "個の要素 (空文字列を分割すると、区切り文字があってもなくても1つの空文字列の要素が返されます)\n\n";
82
83?>

PHP 8のexplode関数は、指定された区切り文字（デリミタ）に基づいて文字列を複数の部分に分割し、その結果を配列として返します。これにより、例えば「りんご,バナナ,みかん」のようなカンマ区切りの文字列から、それぞれのフルーツ名を個別の要素として簡単に取り出すことができます。

第一引数の$delimiterには、文字列を分割するための区切り文字を指定します。PHP 8では、空文字列を区切り文字として渡すとエラーが発生しますのでご注意ください。第二引数の$stringには、分割対象となる元の文字列を渡します。こちらもPHP 8ではnullを渡すとエラーになります。

オプションの第三引数$limitは、返される配列の要素数を制御するために使用します。正の整数を指定すると、最大でその数だけ文字列を分割し、最後の要素には残りの文字列全体が含まれます。負の整数を指定した場合は、最後からその数だけ要素を除外した配列が返されます。0を指定すると、元の文字列がそのまま含まれる1つの要素の配列が返されます。この引数により、得られる「複数の」要素の数を柔軟に調整することが可能です。

戻り値は、分割された部分文字列を含む配列です。区切り文字が元の文字列内で見つからなかった場合でも、元の文字列がそのまま1つの要素として含まれた配列が返されます。サンプルコードでは、基本的な分割方法から$limit引数を使った制御、区切り文字が見つからない場合や空文字列の場合など、複数の状況でのexplode関数の挙動を具体的に示しています。

Copy
1<?php
2
3/**
4 * 複数行の文字列を改行で分割し、各行を表示するサンプルコード。
5 * PHPの`explode`関数を使って、指定したデリミタ（区切り文字）で文字列を配列に分割する方法を示します。
6 * システムエンジニアを目指す初心者向けに、文字列操作の基本を紹介します。
7 */
8function splitStringByNewline(): void
9{
10    // 分割対象となる複数行の文字列を定義します。
11    // ヒアドキュメント構文 (<<<TEXT ... TEXT;) を使用すると、
12    // 複数行の文字列を整形して記述しやすくなります。
13    $multiLineString = <<<TEXT
14こんにちは、PHPの世界へようこそ！
15これはサンプルコードの1行目です。
16これはサンプルコードの2行目です。
17PHP_EOLは環境に依存する改行コードを表します。
18分割された各行を個別に処理する方法を示します。
19TEXT;
20
21    echo "--- 元の複数行文字列 ---" . PHP_EOL;
22    echo $multiLineString . PHP_EOL . PHP_EOL;
23
24    // `explode()` 関数を使用して、文字列を改行コードで分割します。
25    // - 第1引数: 区切り文字 (デリミタ)。ここでは `PHP_EOL` を使います。
26    //   `PHP_EOL` は実行環境（Windowsでは "\r\n"、Unix/Linux/macOSでは "\n"）に
27    //   応じた改行コードを自動的に選択するため、クロスプラットフォームで安全です。
28    // - 第2引数: 分割対象の文字列。
29    $lines = explode(PHP_EOL, $multiLineString);
30
31    echo "--- 分割された各行 ---" . PHP_EOL;
32    // 分割された結果は配列として返されるため、`foreach` ループを使って
33    // 各行を順に処理し、表示することができます。
34    foreach ($lines as $index => $line) {
35        // `trim()` 関数を使って、各行の先頭や末尾にある不要な空白文字（スペース、タブ、改行など）
36        // を取り除くと、出力がよりきれいに表示されます。
37        echo "行 " . ($index + 1) . ": " . trim($line) . PHP_EOL;
38    }
39
40    echo PHP_EOL . "--- 処理完了 ---" . PHP_EOL;
41}
42
43// 定義した関数を実行します。
44splitStringByNewline();

このサンプルコードは、複数行にわたる文字列を改行コードで分割し、それぞれの行を個別に処理する方法をシステムエンジニアを目指す初心者向けに示しています。PHPのexplode関数が、文字列を分割する主要な役割を担います。explode関数は、指定された区切り文字（デリミタ）で文字列を分割し、その結果を文字列の配列として返します。

コードではまず、$multiLineString変数にヒアドキュメント構文を使って複数行の文字列を定義しています。次に、explode(PHP_EOL, $multiLineString)を実行し、$multiLineStringをPHP_EOLで指定された改行コードで分割しています。PHP_EOLは、WindowsやUnix系OSなど、実行環境に応じた適切な改行コードを自動的に選択するため、クロスプラットフォームでの文字列処理に有効です。

explode関数は、分割された各部分を要素とする配列を戻り値として返します。この配列は$lines変数に格納され、foreachループを使って配列の各要素、つまり各行を取り出し表示しています。また、trim()関数を適用することで、各行の先頭や末尾にある不要な空白文字（スペース、タブ、改行など）を取り除き、出力が整った形になるようにしています。この一連の処理は、文字列操作の基本的な技術として、様々なシステム開発で応用できます。