wordwrap

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

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

Описание

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() - Разбивает строку на фрагменты