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

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * 文字列に含まれる各文字の出現回数を数えて表示します。
7 *
8 * この関数は、PHPの `count_chars()` を使用して、
9 * 指定された文字列内に各文字が何回出現するかを計算し、
10 * その結果をコンソールに出力します。
11 *
12 * @param string $text 解析対象の文字列。
13 */
14function displayCharacterFrequency(string $text): void
15{
16    echo "解析する文字列: \"{$text}\"" . PHP_EOL;
17    echo "-------------------------" . PHP_EOL;
18
19    // count_chars() をモード1で使用します。
20    // モード1は、キーに文字のASCIIコード、値に出現回数を持つ連想配列を返します。
21    // このモードでは、一度も出現しなかった文字は結果に含まれません。
22    $charCounts = count_chars($text, 1);
23
24    // 連想配列をループ処理し、結果を分かりやすく表示します。
25    foreach ($charCounts as $asciiCode => $count) {
26        // chr()関数でASCIIコードを実際の文字に変換します。
27        $character = chr($asciiCode);
28        echo "'{$character}' は {$count} 回出現しました。" . PHP_EOL;
29    }
30}
31
32// 解析したい文字列を定義します。
33$sampleString = "Hello, world of PHP 8!";
34
35// 関数を呼び出して、文字列の文字出現回数を表示します。
36displayCharacterFrequency($sampleString);
37
38?>

このサンプルコードは、PHPのcount_chars関数を使用して、指定した文字列に含まれる各文字の出現回数を数える方法を示しています。count_chars関数は、第一引数に解析したい文字列を、第二引数に処理の挙動を決定するモード番号を受け取ります。

コード内のdisplayCharacterFrequency関数では、count_chars関数の第二引数にモード1を指定しています。モード1を指定すると、戻り値として「キーが文字のASCIIコード、値がその文字の出現回数」となる連想配列が返されます。この際、文字列中に一度も出現しなかった文字は、結果の配列に含まれません。

関数が返す連想配列は$charCounts変数に格納された後、foreachループで処理されます。ループ内では、キーであるASCIIコードをchr関数によって人間が読める文字に変換し、値である出現回数と組み合わせて画面に出力しています。この処理により、「'H' は 1 回出現しました。」のように、どの文字が何回使われているかの一覧が分かりやすく表示されます。

Copy
1<?php
2
3/**
4 * PHPの count_chars 関数を使用して、文字列内の各文字の出現回数をカウントするサンプルです。
5 *
6 * count_chars(string $string, int $mode = 0): array|string
7 * mode = 1 は、文字列に出現する各バイト値の出現回数を連想配列で返します。
8 * キーはバイト値 (0-255)、値はその出現回数です。
9 */
10
11// カウント対象のサンプル文字列を定義します。
12$sampleString = "Hello, World!";
13
14// count_chars 関数 (mode = 1) を使用して、各文字の出現回数を取得します。
15// mode = 1 は、出現した文字とその回数を連想配列で返します。
16// 例えば 'H' のASCII値がキーとなり、その出現回数が値となります。
17$charCounts = count_chars($sampleString, 1);
18
19echo "文字列 '{$sampleString}' の文字出現回数:\n";
20
21// 結果を分かりやすく表示します。
22// 配列のキーは文字のASCII値、値はその文字の出現回数です。
23foreach ($charCounts as $asciiValue => $count) {
24    // ASCII値を対応する文字に変換して表示します。
25    echo "  文字 '" . chr($asciiValue) . "' (ASCII値: {$asciiValue}): {$count} 回\n";
26}
27
28?>

PHPのcount_chars関数は、指定された文字列に含まれる各文字の出現回数を数えるために使用されます。この関数は、引数としてカウント対象の文字列$stringと、カウント方法を指定する整数$modeを受け取ります。戻り値は配列または文字列となります。

特に$modeを1に設定した場合、関数は文字列に出現する各バイト値（0〜255）の出現回数を連想配列として返します。この配列のキーは文字のバイト値（ASCII値）、値はそのバイト値を持つ文字の出現回数となります。例えば、文字列に'H'が1回出現した場合、'H'のASCII値である72をキーとし、値1を持つ要素が配列に含まれます。

サンプルコードでは、「Hello, World!」という文字列を$sampleStringとして定義しています。count_chars($sampleString, 1)を実行することで、この文字列内の各文字の出現回数を取得し、$charCounts変数に連想配列として格納しています。

その後、foreachループを使って$charCounts配列を繰り返し処理し、結果を表示しています。配列のキーであるASCII値をchr()関数で対応する文字に変換することで、どの文字が何回出現したかを初心者の方にも分かりやすく出力しています。この機能は、文字列の構成を分析する際に非常に役立ちます。

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * 文字列内に含まれる各文字の出現回数を数えます。
7 *
8 * この関数は、PHPの組み込み関数 `count_chars` を使用して、
9 * 指定された文字列中の各文字（バイト）が何回出現するかを計算し、
10 * 文字をキー、出現回数を値とする連想配列として返します。
11 *
12 * @param string $text 解析対象の文字列。
13 * @return array<string, int> 文字とその出現回数を格納した連想配列。
14 */
15function getCharacterFrequencies(string $text): array
16{
17    // count_chars($text, 1) は、文字列に出現する文字の出現回数を返します。
18    // キーは文字のASCII値、値は出現回数です。
19    // 例: 'a' が1回出現 -> [97 => 1]
20    $byteValueCounts = count_chars($text, 1);
21
22    $charCounts = [];
23    // 連想配列をループし、ASCII値のキーを実際の文字に変換します。
24    foreach ($byteValueCounts as $byteValue => $count) {
25        // chr() 関数はASCII値を文字に変換します。
26        $char = chr($byteValue);
27        $charCounts[$char] = $count;
28    }
29
30    return $charCounts;
31}
32
33// --- 実行コード ---
34
35// 解析したい文字列を定義します。
36$sampleString = 'Hello, World! This is a test.';
37
38// 関数を呼び出して文字の出現回数を取得します。
39$frequencies = getCharacterFrequencies($sampleString);
40
41// 結果を画面に出力します。
42echo "文字列: \"{$sampleString}\"\n";
43echo "----------------------------------\n";
44echo "各文字の出現回数:\n";
45
46foreach ($frequencies as $character => $count) {
47    // スペース文字は分かりにくいので、明示的に表示します。
48    $displayChar = ($character === ' ') ? "' ' (スペース)" : "'{$character}'";
49    echo "{$displayChar}: {$count}回\n";
50}
51
52?>

このPHPサンプルコードは、count_chars関数を利用して、文字列内に含まれる各文字の出現回数を数える方法を示しています。

count_chars関数は、第1引数に解析対象の文字列を、第2引数に処理の形式を指定する$modeを受け取ります。このコードでは$modeに1を指定しています。これにより、文字列中に出現した文字のバイト値（文字コード）をキーとし、その出現回数を値とする連想配列が返されます。例えば、'a'が1回出現した場合、キーが97（'a'の文字コード）、値が1となります。

しかし、キーが数値のままでは直感的に分かりにくいため、getCharacterFrequenciesという独自の関数内でひと手間加えています。foreachループでcount_chars関数の結果を一つずつ処理し、chr関数を使ってキーであるバイト値を実際の文字に変換しています。そして、文字をキー、出現回数を値とする、より人間が理解しやすい新しい連想配列を再構築して返します。

最後に、この関数を使って得られた結果を画面に分かりやすく表示しています。

Copy
1<?php
2
3/**
4 * 指定された文字列内の各文字の出現回数を数え、結果を表示します。
5 *
6 * @param string $text 出現回数を数える対象の文字列。
7 */
8function countSpecificCharsInString(string $text): void
9{
10    echo "元の文字列: \"" . $text . "\"\n\n";
11    echo "--- 各文字の出現回数 ---\n";
12
13    // count_chars 関数を使用して、文字列内の各バイト値の出現回数を数えます。
14    // モード 1 は、出現回数が 1 以上の文字のみを連想配列として返します。
15    // 配列のキーは文字の ASCII 値 (0-255)、値はその出現回数です。
16    $charCounts = count_chars($text, 1);
17
18    // 結果を分かりやすく表示します。
19    if (empty($charCounts)) {
20        echo "この文字列には文字が含まれていません。\n";
21    } else {
22        foreach ($charCounts as $asciiCode => $count) {
23            // ASCII 値を対応する文字に変換して表示します。
24            echo "'" . chr($asciiCode) . "' (ASCII: " . $asciiCode . "): " . $count . " 回\n";
25        }
26    }
27}
28
29// 使用例
30$sampleString = "Hello, PHP 8! This is a simple test string for count_chars function.";
31countSpecificCharsInString($sampleString);
32
33echo "\n---\n\n";
34
35// 別の使用例 (空文字列)
36$emptyString = "";
37countSpecificCharsInString($emptyString);
38
39?>

PHPのcount_chars関数は、与えられた文字列に含まれる各文字（正確には各バイト値）の出現回数を数える際に使用されます。この関数は、文字列データを分析する上で非常に便利な機能であり、システムエンジニアを目指す初心者の方にも、その基本的な使い方を理解していただくことをお勧めします。

この関数は、string $stringとint $mode = 0の二つの引数を取ります。$stringには、出現回数を数えたい対象の文字列を指定します。$modeはオプションで、関数の戻り値の形式を決定します。例えば、サンプルコードで使用されているmode = 1の場合、出現回数が1以上の文字（バイト値）のみを、キーがその文字のASCII値、値が出現回数である連想配列として返します。これにより、文字列に実際に含まれる文字とその頻度を効率的に把握できます。

count_chars関数の戻り値は、$modeの値によってarray型またはstring型になります。サンプルコードのようにmode = 1が指定された場合は配列が返され、各文字のASCII値がキーとなり、その出現回数が値として格納されます。コード内では、この戻り値の配列をforeachループで処理し、chr()関数を用いてASCII値を対応する文字に変換して表示しています。これにより、どの文字が何回出現したかを初心者の方にも分かりやすく出力し、文字列の構成を視覚的に理解することができます。