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

# ucwords

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

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

### Описание

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open