(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — 文字列の各単語の最初の文字を大文字にする
$string
, string $separators
= " \t\r\n\f\v"): string
文字がアルファベットの場合、string
の各単語の最初の文字を大文字にしたものを返します。
この関数における "単語" とは、
separators
に含まれていない文字からなる文字列です。
separators
のデフォルトはスペース、
フォームフィード、改行、キャリッジリターン、
水平タブ、垂直タブ です。
string
入力文字列。
separators
オプションの separators
で、単語の区切り文字を指定します。
変更後の文字列を返します。
例1 ucwords() の例
<?php
$foo = 'hello world!';
$foo = ucwords($foo); // Hello World!
$bar = 'HELLO WORLD!';
$bar = ucwords($bar); // HELLO WORLD!
$bar = ucwords(strtolower($bar)); // Hello World!
?>
例2 ucwords() で、区切り文字を指定する例
<?php
$foo = 'hello|world!';
$bar = ucwords($foo); // Hello|world!
$baz = ucwords($foo, "|"); // Hello|World!
?>
例3 ucwords() で、追加の区切り文字を指定する例
<?php
$foo = "mike o'hara";
$bar = ucwords($foo); // Mike O'hara
$baz = ucwords($foo, " \t\r\n\f\v'"); // Mike O'Hara
?>
注意: この関数はロケールを認識し、入力を現在設定されているロケールに従って処理します。しかしながら、この入力の処理はシングルバイトの文字セットでのみ動作します。マルチバイト文字(大半の西ヨーロッパ言語以外のそれが該当します)を扱う必要がある場合、mbstring や intl 拡張モジュールを調べてみて下さい。
注意: この関数はバイナリデータに対応しています。