Effectue la césure d'une chaîne

# wordwrap

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

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

### Description

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

Effectue la césure d'une chaîne. Les chaînes se coupent après un caractère d'espace (U+0020) à moins que `cut_long_words` ne soit défini sur `true`.

### Liste de paramètres

`string`

  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 `break`. Cela ne doit pas être une chaîne vide.

`cut_long_words`

  Si le paramètre `cut_long_words` vaut `true`, la césure de la chaîne sera toujours à la taille `width` ou avant. Si l'on a 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.

### Erreurs / Exceptions

Si `break` est une chaîne vide, une ValueError est levée.

### Historique

Version | Description
--- | ---
8.0.0 | Si `break` est une chaîne vide, une ValueError est levée; auparavant, dans ce cas, cela émettait un `E_WARNING` et retournait `false`.

### 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 blond<br />
    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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open