(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — Переводит в верхний регистр первый символ каждого слова в строке
Функция возвращает строку string
,
в которой привела в верхний регистр первый символ каждого слова,
если символ относится к ASCII-символам в диапазоне от кодовой точки 0x61 для символа "a"
до кодовой точки 0x7a для символа "z"
.
Функция понимает как слово последовательность символов, которая не включают символы из параметра separators
.
К разделителям по умолчанию относятся: пробел, горизонтальная табуляция, возврат каретки, перевод строки, разрыв страницы и вертикальная табуляция.
Для аналогичного преобразования многобайтовых строк
вызывают функцию mb_convert_case() в режиме MB_CASE_TITLE
.
string
Входная строка.
separators
Необязательный параметр separators
содержит символы разделителей слов.
Функция возвращает модифицированную строку.
Версия | Описание |
---|---|
8.2.0 | Приведение к единому регистру больше не зависит от региональных настроек, которые установили функцией setlocale(). Преобразовываются только символы кодировки ASCII. |
Пример #1 Пример перевода в верхний регистр первого символа каждого слова строки функцией ucwords()
<?php
$foo = 'hello world!';
echo ucwords($foo), PHP_EOL; // Hello World!
$bar = 'HELLO WORLD!';
echo ucwords($bar), PHP_EOL; // HELLO WORLD!
echo ucwords(strtolower($bar)), PHP_EOL; // Hello World!
?>
Пример #2 Пример работы функции ucwords() с пользовательским разделителем
<?php
$foo = 'hello|world!';
echo ucwords($foo), PHP_EOL; // Hello|world!
echo ucwords($foo, "|"), PHP_EOL; // Hello|World!
?>
Пример #3 Пример работы функции ucwords() с дополнительными разделителями
<?php
$foo = "mike o'hara";
echo ucwords($foo), PHP_EOL; // Mike O'hara
echo ucwords($foo, " \t\r\n\f\v'"), PHP_EOL; // Mike O'Hara
?>
Замечание: Функция безопасна для обработки данных в двоичной форме.