Start · Sprachen · PHP · Referenz · str_replace

str_replace

Funktion

Ersetzt alle Vorkommen eines Strings (oder mehrerer) durch einen anderen. Case-sensitive.

seit PHP 4.0.0 Kategorie: string

Signatur

str_replace(array|string $search, array|string $replace, string|array $subject, int &$count = null): string|array

Beschreibung

Kann mit einzelnen Strings oder mit Arrays arbeiten: str_replace(['a', 'b'], ['x', 'y'], $s).

Für case-insensitive: str_ireplace().

Parameter

Name Typ Default Beschreibung
$search Pflicht array|string Gesuchte Werte.
$replace Pflicht array|string Ersatzwerte.
$subject Pflicht string|array String oder Array zum Durchsuchen.
$count int& null Optional: Anzahl Ersetzungen (Ref).

Rückgabewert

Typ
string|array
Beschreibung
Ergebnis mit Ersetzungen.

Beispiele

Single-Value

<?php

echo str_replace('.net', '.de', 'programmierung.net'); // programmierung.de

Mehrere Ersetzungen

<?php

echo str_replace(['ä','ö','ü'], ['ae','oe','ue'], 'Größe'); // Groesse

// Wichtig · Fallstricke

Achtung Reihenfolge: Ersetzungen laufen sequenziell. str_replace(['a', 'b'], ['b', 'c'], 'a') ergibt 'c', nicht 'b'!

Siehe auch