# 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

使用字符串断点将字符串打断为指定数量的字串。除非 `cut_long_words` 设置为 `true`，否则字符串将会在空格（U+0020）后换行。

### 参数

`string`

  输入字符串。

`width`

  列宽度。

`break`

  使用可选的 `break` 参数打断字符串。不能是空字符串。

`cut_long_words`

  如果 `cut_long_words` 设置为 `true`，字符串总是在指定的 `width` 或者之前位置被打断。因此，如果有的单词宽度超过了给定的宽度，它将被分隔开来。（参见第二个示例）。当它是 `false`，函数不会分割单词，哪怕 `width` 小于单词宽度。

### 返回值

返回打断后的字符串。

### 错误／异常

如果 `break` 是空字符串，抛出 ValueError。

### 更新日志

版本 | 说明
--- | ---
8.0.0 | 如果 `break` 是空字符串，抛出 ValueError；之前此情况会触发 `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() - 将字符串分割成小块

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open