# wordwrap

(PHP 4 >= 4.0.2, PHP 5)

wordwrap — Wraps a string to a given number of characters

### Description

string wordwrap ( string `$str` [, int `$width` [, string `$break` [, bool `$cut` ]]] )

Wraps a string to a given number of characters using a string break character.

### Parameters

`str`

  The input string.

`width`

  The column width. Defaults to 75.

`break`

  The line is broken using the optional `break` parameter. Defaults to '\n'.

`cut`

  If the `cut` is set to `TRUE`, the string is always wrapped at the specified width. So if you have a word that is larger than the given width, it is broken apart. (See second example).

### Return Values

Returns the given string wrapped at the specified column.

### ChangeLog

Version | Description
--- | ---
4.0.3 | The optional `cut` parameter was added.

### 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.

### See Also

- nl2br()
- chunk_split()