ucwords

(PHP 4, PHP 5, PHP 7, PHP 8)

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

Описание

ucwords(string $string, string $separators = " \t\r\n\f\v"): string

Функция возвращает строку 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

?>

Примечания

Замечание: Функция безопасна для обработки данных в двоичной форме.

Смотрите также

  • strtoupper() - Приводит строку к верхнему регистру
  • strtolower() - Приводит строку к нижнему регистру
  • ucfirst() - Переводит первый символ строки в верхний регистр
  • mb_convert_case() - Меняет регистр символов в строке