ucwords

(PHP 4, PHP 5, PHP 7)

ucwordsПреобразует в верхний регистр первый символ каждого слова в строке

Описание

ucwords ( string $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() - Производит смену регистра символов в строке