ucwords

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

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

Описание

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

Возвращает строку 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
?>

Примечания

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

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

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