Quebra uma string em um dado número de caracteres

Descrição

wordwrap(
    string $string,
    int $width = 75,
    string $break = "\n",
    bool $cut_long_words = false
): string

Quebra uma string em um dado número de caracteres usando um caractere de quebra de string. As strings são quebradas após um caractere de espaço (U+0020) a menos que cut_long_words seja definido para true.

Parâmetros

string: A string de entrada.
width: O número de caracteres nos quais a string será quebrada.
break: A linha é quebrada inserindo o caractere informado no parâmetro opcional break. Não pode ser uma string vazia. O padrão é "\n".
cut_long_words: Se cut_long_words for definido para true, a string será sempre quebrada na largura especificada em width ou antes. Então se existir uma palavra mais longa que a largura informada, ela será quebrada (veja o segundo exemplo). Quando for definido para false, a função não quebrará a palavra mesmo se width for menor que o comprimento dela.

Valor Retornado

Retorna a string informada quebrada na largura especificada.

Erros/Exceções

Se break for uma string vazia, uma exceção ValueError é lançada.

Registro de Alterações

Versão	Descrição
8.0.0	Se `break` for uma string vazia, uma exceção ValueError é lançada; anteriormente, neste caso, um `E_WARNING` era emitido e a função retornava `false`.

Exemplos

Example #1 Exemplo de wordwrap()

<?php
$text = "Um pequeno jabuti xereta viu dez cegonhas felizes.";
$newtext = wordwrap($text, 20, "<br />\n");

echo $newtext;
?>

O exemplo acima produzirá:

Um pequeno jabuti<br />
xereta viu dez<br />
cegonhas felizes.

Example #2 Exemplo de wordwrap()

<?php
$text = "Uma longa palaaaaaaaaavra.";
$newtext = wordwrap($text, 8, "\n", true);

echo "$newtext\n";
?>

O exemplo acima produzirá:

Uma
longa
palaaaaa
aaaavra.

Example #3 Exemplo de wordwrap()

<?php
$text = "Uma longa palaaaaaaaaaaaaaaavra e reticências";
$newtext = wordwrap($text, 8, "\n", false);

echo "$newtext\n";
?>

O exemplo acima produzirá:

Uma
longa
palaaaaaaaaaaaaaaavra
e
reticências

Veja Também

nl2br() - Insere quebras de linha HTML antes de todos os caracteres de nova linha em um string
chunk_split() - Divide uma string em pedaços menores