(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
wordwrap — Quebra uma string em um dado número de caracteres
$string,$width = 75,$break = "\n",$cut_long_words = false
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.
stringA string de entrada.
widthO 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.
Retorna a string informada quebrada na largura especificada.
Se break for uma string vazia,
uma exceção ValueError é lançada.
| 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.
|
Exemplo #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.
Exemplo #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.
Exemplo #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