wordwrap

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

wordwrapWraps a string to a given number of characters

Description

wordwrap ( 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 to true, the string is always wrapped at or before the specified width. So if you have a word that is larger than the given width, it is broken apart. (See second example). When false the function does not split the word even if the width 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

© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.wordwrap.php