PHP Handbuch
Zurück |  | Weiter

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

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

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 :) ... "; 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ück | Zum Anfang | Weiter
substr | Nach oben | ucfirst