PHPのucwords()関数とは？構文と使い方を実例付きで解説

ucwords()関数は、文字列に含まれる各単語の先頭の1文字を大文字へ変換するためのPHP組み込み関数です。記事タイトルや見出しなど、単語ごとに頭文字を大文字表記へ整えたい場面で便利に使えます。

構文

ucwords(str, delimiters)

パラメータ

• str − 変換対象となる入力文字列。

• delimiters（任意） − 単語の始まりとみなす区切り文字を指定します。デフォルトでは、半角スペース・タブ・改行などの空白文字が区切りとして扱われます。第2引数を指定した場合は、そこで指定した文字だけが区切りとみなされる点に注意してください。

戻り値

ucwords()関数は、変換後の文字列を返します。

使用例

まずは、もっとも基本的な使い方から見ていきましょう。

<?php
    echo ucwords("This is it!");
?>

実行結果

上記コードの出力は次のとおりです。

This Is It!

各単語の先頭文字が自動的に大文字へ変換されていることが分かります。

区切り文字を指定した使用例

続いて、第2引数で区切り文字を明示的に指定した例を確認してみましょう。

<?php
    $s = "#demo#text";
    $sep = '$';
    $res = ucwords($s, $sep);
    print_r($res);
?>

実行結果

上記コードの出力は次のとおりです。

#demo#text

この例では区切り文字として「$」を指定していますが、対象の文字列の中に「$」は存在しないため、どこも単語の始まりと判定されず、結果は元の文字列のまま変化していません。このように、delimitersを指定すると、デフォルトの空白文字は区切りとして扱われなくなるため、意図した動作を得るには区切り文字の指定内容に注意が必要です。

補足：マルチバイト文字の扱い

ucwords()はシングルバイト文字を前提とした関数のため、日本語などのマルチバイト文字列に対しては期待どおりに動作しない場合があります。マルチバイト対応が必要なケースでは、mbstring拡張モジュールを利用した処理を検討するとよいでしょう。