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