(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
wordwrap — Переносит строку через заданное количество символов
$string,$width = 75,$break = "\n",$cut_long_words = false
Функция переносит строку через заданное количество символов
и вставляет в место переноса символ переноса строки.
Строки переносятся после символа пробела, который в таблице Юникода назначили кодовой точке 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