PHP Handbuch
ZurückWeiter

trim

(PHP 3, PHP 4, PHP 5)

trim --  Entfernt Whitespaces (oder andere Zeichen) am Anfang und Ende eines Strings

Beschreibung

string trim ( string str [, string charlist] )

Die Funktion entfernt Whitespaces an Anfang und Ende von str und gibt den String dann zurück. Ohne Verwendung des zweiten Parameters entfernt trim() folgende Zeichen:

Parameter Liste

str

string erwartet die zu trimmende Zeichenkette.

charlist

Optional kann eine Liste weiterer Zeichen angefügt werden, die an Anfang und Ende der Zeichenkette entfernt werden sollen. Um diese Zeichen anzugeben, wird der charlist Parameter verwendet. Er enthält eine Liste aller zu entfernenden Zeichen. Mit .. können darüber hinaus auch ganze Bereiche von Zeichen angegeben werden.

Rückgabewerte

Der gekürzte String.

ChangeLog

VersionBeschreibung
4.1.0 Einführung des optionalen charlist Parameters.

Beispiele

Beispiel 1. Beispiel zur Verwendung von trim()

<?php

$text = "\t\tDieser Text besteht aus mehreren Wörtern :) ...  ";

echo trim($text);           // "Dieser Text besteht aus mehreren Wörtern :) ..."
echo trim($text, " \t.");   // "Dieser Text besteht aus mehreren Wörtern :)"

// Trimmen der ASCII Steuerzeichen an Anfang und Ende von $binary
// (inklusive der Zeichen von ASCII 0 bis 31)
$clean = trim($binary, "\x00..\x1F");

?>

Beispiel 2. Trimmen von Array Werten mittels trim()

<?php
function trim_value(&$value)
{
    $value = trim($value);
}

$fruechte = array('Apfel','Banane ', ' Preiselbeere ');
var_dump($fruechte);

array_walk($fruechte, 'trim_value');
var_dump($fruechte);

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

array(3) {
  [0]=>
  string(5) "Apfel"
  [1]=>
  string(7) "Banane "
  [2]=>
  string(11) " Preiselbeere "
}
array(3) {
  [0]=>
  string(5) "Apfel"
  [1]=>
  string(6) "Banane"
  [2]=>
  string(9) "Preiselbeere"
}

Siehe auch

ltrim()
rtrim()

ZurückZum AnfangWeiter
substrNach obenucfirst