ucwords
(PHP 4, PHP 5, PHP 7)
ucwords — Преобразует в верхний регистр первый символ каждого слова в строке
Описание
$string
, string $separators
= " \t\r\n\f\v"
) : string
Возвращает строку string
, в которой первый
символ каждого слова переведен в верхний регистр, если этот символ
является буквой.
Словом при этом является любая последовательность символов, следующая непосредственно
за любым из символов, перечисленных в параметре 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
?>
Примечания
Замечание: Функция зависит от локали и будет обрабатывать ввод в соответствии с текущим установленным языковым стандартом. Однако она работает только с однобайтовыми наборами символов. Если вам нужно использовать многобайтовые символы (большинство языков, не входящих в Западную Европу), обратите внимание на модули multibyte или intl вместо нее.
Замечание: Эта функция безопасна для обработки данных в двоичной форме.
Смотрите также
- strtoupper() - Преобразует строку в верхний регистр
- strtolower() - Преобразует строку в нижний регистр
- ucfirst() - Преобразует первый символ строки в верхний регистр
- mb_convert_case() - Производит смену регистра символов в строке