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