wordwrap
(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
wordwrap — Wraps a string to a given number of characters
Description
string
$string
,int
$width
= 75,string
$break
= "\n",bool
$cut_long_words
= false
): string
Wraps a string to a given number of characters using a string break character.
Parameters
-
string
-
The input string.
-
width
-
The number of characters at which the string will be wrapped.
-
break
-
The line is broken using the optional
break
parameter. -
cut_long_words
-
If the
cut_long_words
is set totrue
, the string is always wrapped at or before the specifiedwidth
. So if you have a word that is larger than the given width, it is broken apart. (See second example). Whenfalse
the function does not split the word even if thewidth
is smaller than the word width.
Return Values
Returns the given string wrapped at the specified length.
Examples
Example #1 wordwrap() example
<?php
$text = "The quick brown fox jumped over the lazy dog.";
$newtext = wordwrap($text, 20, "<br />\n");
echo $newtext;
?>
The above example will output:
The quick brown fox<br /> jumped over the lazy<br /> dog.
Example #2 wordwrap() example
<?php
$text = "A very long woooooooooooord.";
$newtext = wordwrap($text, 8, "\n", true);
echo "$newtext\n";
?>
The above example will output:
A very long wooooooo ooooord.
Example #3 wordwrap() example
<?php
$text = "A very long woooooooooooooooooord. and something";
$newtext = wordwrap($text, 8, "\n", false);
echo "$newtext\n";
?>
The above example will output:
A very long woooooooooooooooooord. and something
See Also
- nl2br() - Inserts HTML line breaks before all newlines in a string
- chunk_split() - Split a string into smaller chunks