array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.ucwords.php', 1 => 'ucwords', 2 => 'Переводит в верхний регистр первый символ каждого слова в строке', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Функции для работы со строками', ), 'prev' => array ( 0 => 'function.ucfirst.php', 1 => 'ucfirst', ), 'next' => array ( 0 => 'function.utf8-decode.php', 1 => 'utf8_decode', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/strings/functions/ucwords.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

?>

Примечания

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

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