(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — Преобразовывает в верхний регистр первый символ каждого слова в строке
Возвращает строку string
, в которой первый
символ каждого слова переведён в верхний регистр, если этот символ
является символом ASCII между "a"
(0x61) и "z"
(0x7a).
Для этой функции слово - это строка символов, не перечисленных в separators
.
По умолчанию это: пробел, горизонтальная табуляция, возврат каретки, перевод строки, разрыв страницы и вертикальная табуляция.
Чтобы сделать аналогичное преобразование многобайтовых строк,
используйте функцию mb_convert_case() с режимом MB_CASE_TITLE
.
string
Входная строка.
separators
Необязательный параметр separators
содержит символы разделителей слов.
Возвращает модифицированную строку.
Версия | Описание |
---|---|
8.2.0 | Приведение к единому регистру больше не зависит от региональных настроек, которые установили функцией setlocale(). Преобразовываются только символы кодировки ASCII. |
Пример #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
?>
Замечание: Функция безопасна для обработки данных в двоичной форме.