Переносит строку через заданное количество символов

# wordwrap

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

wordwrap — Переносит строку через заданное количество символов

### Описание

function wordwrap(
string `$string`,
int `$width` = 75,
string `$break` = "\n",
bool `$cut_long_words` = `false`
): string

Функция переносит строку через заданное количество символов и вставляет в место переноса символ переноса строки. Строки переносятся после символа пробела, который в таблице Юникода назначили кодовой точке U+0020, если только параметру `cut_long_words` не установили значение `true`.

### Список параметров

`string`

  Входная строка.

`width`

  Количество символов, через которое функция перенесёт строку.

`break`

  Функция переносит строку символом, который указали в необязательном параметре `break`. Нельзя указывать как символ переноса пустую строку.

`cut_long_words`

  Функция переносит строку через ширину `width` или раньше, если для параметра `cut_long_words` установили значение `true`. Поэтому слова, длина которых превышает ширину, разбиваются на части, как во втором примере. Функция не разбивает слово, даже если ширина `width` меньше длины слова, если для параметра установили значение `false`.

### Возвращаемые значения

Функция возвращает строку с символами переноса на заданной длине.

### Ошибки

Функция выбросит исключение ValueError, если параметр `break` окажется пустой строкой.

### Список изменений

Версия | Описание
--- | ---
8.0.0 | Функция выбросит исключение ValueError, если параметр `break` окажется пустой строкой; раньше выдавалась ошибка уровня `E_WARNING` и возвращалось значение `false`.

### Примеры

Пример #1 Пример переноса строки функцией wordwrap()

    <?php

    $text = "The quick brown fox jumped over the lazy dog.";
    $newtext = wordwrap($text, 20, "<br />\n");

    echo $newtext;

    ?>

Результат выполнения приведённого примера:

    The quick brown fox<br />
    jumped over the lazy<br />
    dog.

Пример #2 Пример переноса длинного слова функцией wordwrap() с параметром обрезки длинных слов

    <?php

    $text = "A very long woooooooooooord.";
    $newtext = wordwrap($text, 8, "\n", true);

    echo "$newtext\n";

    ?>

Результат выполнения приведённого примера:

    A very
    long
    wooooooo
    ooooord.

Пример #3 Пример переноса длинного слова функцией wordwrap() без параметра обрезки длинных слов

    <?php

    $text = "A very long woooooooooooooooooord. and something";
    $newtext = wordwrap($text, 8, "\n", false);

    echo "$newtext\n";

    ?>

Результат выполнения приведённого примера:

    A very
    long
    woooooooooooooooooord.
    and
    something

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

- nl2br() - Вставляет HTML-код разрыва строки перед каждым переводом строки
- chunk_split() - Разбивает строку на фрагменты

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