Effectue la césure d'une chaîne

# wordwrap

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

wordwrap — Effectue la césure d'une chaîne

### Description

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

Effectue la césure d'une chaîne.

### Liste de paramètres

`str`

  La chaîne d'entrée.

`width`

  Le nombre de caractères à partir duquel la chaîne sera coupée.

`break`

  La ligne est rompue en utilisant ce paramètre optionnel.

`cut`

  Si le paramètre `cut` vaut `TRUE`, la césure de la chaîne sera toujours à la taille `width` ou avant. Si vous avez un mot qui est plus long que la taille de césure, il sera coupé en morceaux : voir le second exemple. Lorsque vaut `FALSE`, la fonction ne va pas couper le mot, même si le paramètre `width` est plus petit que la taille du mot.

### Valeurs de retour

Retourne la chaîne fournie coupée à la longueur spécifiée.

### Exemples

Exemple #1 Exemple avec wordwrap()

`<?php
$text = "Portez ce vieux whisky au juge blond qui fume.";
$newtext = wordwrap($text, 20, "<br />\n");
echo $newtext;
?>`

L'exemple ci-dessus va afficher :

    Portez ce vieux<br />
    whisky au juge<br />
    blond qui fume.

Exemple #2 Exemple avec wordwrap()

`<?php
$text = "Un mot très très loooooooooooooooooong.";
$newtext = wordwrap($text, 8, "\n", true);
echo "$newtext\n";
?>`

L'exemple ci-dessus va afficher :

    Un mot
    très
    très
    looooooo
    oooooooo
    ooong.

Exemple #3 Exemple avec wordwrap()

`<?php
$text = "A very long woooooooooooooooooord. and something";
$newtext = wordwrap($text, 8, "\n", false);
echo "$newtext\n";
?>`

L'exemple ci-dessus va afficher :

    A very
    long
    woooooooooooooooooord.
    and
    something

### Voir aussi

- nl2br() - Insère un retour à la ligne HTML à chaque nouvelle ligne
- chunk_split() - Scinde une chaîne