Forum und email
Chaînes
PHP Manual

trim

(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

Example#1 Exemple avec trim()

<?php

$text   = "\t\tVoici quelques mots :) ...  ";
$binary = "\x09Exemple de chaîne\x0A";
$hello  = "Bonjour le monde !";
var_dump($text, $binary, $hello);

print "\n";

$trimmed = trim($text);
var_dump($trimmed);

$trimmed = trim($text, " \t.");
var_dump($trimmed);

$trimmed = trim($hello, "Bjro");
var_dump($trimmed);

// Supprime les caractères de contrôle ASCII au début et Ã  la fin de $binary
// (de 0 Ã  31 inclusif)
$clean = trim($binary, "\x00..\x1F");
var_dump($clean);

?>

L'exemple ci-dessus va afficher :

string(32) "        Voici quelques mots :) ...  "
string(16) "    Exemple de chaîne
"
string(11) "Bonjour le monde !"

string(28) "Voici quelques mots :) ..."
string(24) "Voici quelques mots :)"
string(5) "nur le mnde !"
string(14) "Exemple de chaîne"

Example#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

Chaînes
PHP Manual