Manuel PHP
Précédent |  | Suivant

# trim

(PHP 3, PHP 4, PHP 5)

trim -- Supprime les espaces (ou d'autres caractères) en début et fin de chaîne

## Description

string trim ( string str [, string charlist] )

trim() retourne la chaîne `str`, après avoir supprimé les caractères invisibles en début et fin de chaîne. Si le second paramètre `charlist` est omis, trim() supprimera les caractères suivants :

- "`` " (ASCII `32` (`0x20`)), un espace ordinaire.

- "`\t`" (ASCII `9` (`0x09`)), une tabulation.

- "`\n`" (ASCII `10` (`0x0A`)), une nouvelle ligne (`line feed`).

- "`\r`" (ASCII `13` (`0x0D`)), un retour chariot (`carriage return`).

- "`\0`" (ASCII `0` (`0x00`)), le caractère `NUL`.

- "\x0B" (ASCII `11` (`0x0B`)), une tabulation verticale.

## Liste de paramètres

`str`

  La chaîne de caractères qui sera coupé.

`charlist`

  Optionnellement, les caractères supprimés peuvent aussi être spécifiés en utilisant le paramètre `charlist`. Listez simplement tous les caractères que vous voulez supprimer. Avec `..` vous pouvez spécifier une plage de caractères.

## Valeurs de retour

La chaîne de caractères coupée.

## Historique

Version | Description
--- | ---
4.1.0 | Le paramètre optionnel `charlist` a été ajouté.

## Exemples

Exemple 1. Exemple avec trim()

`<?php $text = "\t\tVoici quelques mots :) ... "; echo trim($text); // "Voici quelques mots :) ..." echo trim($text, " \t."); // "Voici quelques mots :)" // supprime tous les caractères de contrôle ASCII au début de la chaîne de caractères. // (de 0 à 31 inclus) $clean = trim($binary, "\x00..\x1F"); ?>`

Exemple 2. Suppression de caractères dans un tableau avec trim()

`<?php function trim_value(&$value) { $value = trim($value); } $fruit = array('pomme','banane ', ' canneberge '); var_dump($fruit); array_walk($fruit, 'trim_value'); var_dump($fruit); ?>`

L'exemple ci-dessus va afficher :

    array(3) {
      [0]=>
      string(5) "pomme"
      [1]=>
      string(7) "banane "
      [2]=>
      string(11) " canneberge "
    }
    array(3) {
      [0]=>
      string(5) "pomme"
      [1]=>
      string(6) "banane"
      [2]=>
      string(9) "canneberge"
    }

## Voir aussi

ltrim()
rtrim()

Précédent | Sommaire | Suivant
substr | Niveau supérieur | ucfirst