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() - Меняет регистр символов в строке
To Top