substr
ucfirst
String-Funktionen
PHP Manual

# trim

(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:

- " " (ASCII 32 (0x20)), ein normales Leerzeichen.
- "\t" (ASCII 9 (0x09)), ein Tabulatorzeichen.
- "\n" (ASCII 10 (0x0A)), einen Zeilenvorschub (Line Feed).
- "\r" (ASCII 13 (0x0D)), ein Wagenrücklaufzeichen (Carriage Return).
- "\0" (ASCII 0 (0x00)), das NUL-Byte.
- "\x0B" (ASCII 11 (0x0B)), ein vertikaler Tabulator.

### Parameter-Liste

`str`

  string erwartet die zu trimmende Zeichenkette.

`charlist`

  Optional kann die Liste der Zeichen angegeben 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

Version | Beschreibung
--- | ---
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 :) ... ";
$binary = "\x09Beispeilhafter String\x0A";
$hello = "Hallo Welt";
var_dump($text, $binary, $hello);
print "\n";
$trimmed = trim($text);
var_dump($trimmed);
$trimmed = trim($text, " \t.");
var_dump($trimmed);
$trimmed = trim($hello, "Htla");
var_dump($trimmed);
// Trimmen der ASCII Steuerzeichen an Anfang und Ende von $binary
// (inklusive der Zeichen von ASCII 0 bis 31)
$clean = trim($binary, "\x00..\x1F");
var_dump($clean);
?>`

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    string(51) "		Dieser Text besteht aus mehreren Wörtern :) ...  "
    string(23) "	Beispeilhafter String
    "
    string(10) "Hallo Welt"

    string(47) "Dieser Text besteht aus mehreren Wörtern :) ..."
    string(43) "Dieser Text besteht aus mehreren Wörtern :)"
    string(4) "o We"
    string(21) "Beispeilhafter String"

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()

substr
ucfirst
String-Funktionen
PHP Manual