指定した文字数で文字列を分割する

# wordwrap

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

wordwrap — 指定した文字数で文字列を分割する

### 説明

wordwrap ( string `$str` [, int `$width` = 75 [, string `$break` = "\n" [, bool `$cut` = `FALSE` ]]] ) : string

指定した文字数で、指定した文字を用いて文字列を分割します。

### パラメータ

`str`

  入力文字列。

`width`

  文字列を分割するときの文字数。

`break`

  オプションのパラメータ `break` を用いて行を分割します。

`cut`

  `cut` を `TRUE` に設定すると、 文字列は常に指定した `width` でラップされます。このため、 指定した幅よりも長い単語がある場合には、分割されます (2 番目の例を参照ください)。 `FALSE` にすると、たとえ `width` が単語の長さより短かった場合でも、その単語を分割しません。

### 返り値

受け取った文字列を指定した長さで分割したものを返します。

### 例

例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() - 文字列をより小さな部分に分割する