PHPのstr_word_count()関数とは？使い方とパラメータを徹底解説

PHPのstr_word_count()関数は、文字列内で使用されている単語に関する情報を取得するための組み込み関数です。単語の総数をカウントしたり、文字列に含まれる単語を配列として抽出したりすることができます。

基本構文

str_word_count(str, return, char)

パラメータ

• str − 検査対象となる文字列を指定します。

• return − str_word_count()関数の戻り値の形式を指定します。

• returnパラメータには以下の値を指定できます。

  • 0 − 文字列内で見つかった単語の総数（数値）を返します。

  • 1 − 文字列から抽出したすべての単語を含む配列を返します。

  • 2 − キーが文字列内における単語の位置（オフセット）、値が実際の単語である連想配列を返します。

• char − 単語の一部として扱いたい特殊文字を指定します（省略可能）。ハイフンやアポストロフィなどを含めたい場合に便利です。

戻り値

str_word_count()関数は、returnパラメータの値に応じて、配列または数値を返します。デフォルトでは「0」が設定されており、単語数が返されます。

使用例

以下は、文字列から単語を配列として取得する例です。

<?php
print_r(str_word_count("Demo text!", 1));
?>

実行結果

Array (
    [0] => Demo
    [1] => text
)

このように、returnパラメータに「1」を指定すると、文字列内の各単語が順番に格納された配列が出力されます。「0」を指定すれば単語数、「2」を指定すれば単語の位置情報付きの配列が得られるため、用途に応じて柔軟に使い分けることができます。