str_replace

(PHP 4, PHP 5, PHP 7, PHP 8)

str_replaceErsetzt alle Vorkommen des Suchstrings durch einen anderen String

Beschreibung

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

Diese Funktion gibt einen String oder ein Array zurück, in dem alle Vorkommen von search innerhalb von subject durch den angegebenen replace-Wert ersetzt wurden.

Wenn Sie keine ausgefallenen Ersetzungsregeln (wie Reguläre Ausdrücke) benötigen, sollten Sie diese Funktion anstelle von preg_replace() verwenden.

Parameter-Liste

Sind search und replace Arrays, nimmt str_replace() je einen Wert beider Arrays und verwendet diese zum Suchen und Ersetzen in subject. Hat replace weniger Werte als search, so wird ein leerer String zum Ersetzen für den Rest der Werte verwendet. Ist search ein Array und replace ein String, dann wird dieser String für jeden Wert von search angewandt. Das Gegenteil ist nicht sinnvoll.

Sind search und/oder replace Arrays, werden ihre Elemente vom ersten zum letzten hin verarbeitet.

search

Der gesuchte Wert, auch Nadel (needle) genannt. Ein Array kann genutzt werden, um mehrere Nadeln zu bestimmen.

replace

Der Ersetzungswert, der gefundene search Werte ersetzt. Ein Array kann genutzt werden, um mehrere Werte zu bestimmen.

subject

Die zu durchsuchende und darin enthaltene zu ersetzende Zeichenkette oder das Array, auch Heuhaufen (haystack) genannt.

Ist subject ein Array, erfolgt das Suchen und Ersetzen für jeden Wert von subject, und der Rückgabewert ist ebenfalls ein Array.

count

Falls übergeben, wird dies auf die Anzahl der durchgeführten Ersetzungen gesetzt.

Rückgabewerte

Diese Funktion gibt eine Zeichenkette oder ein Array mit ersetzten Werten zurück.

Beispiele

Beispiel #1 Grundlegende str_replace()-Beispiele

<?php
// Liefert: <body text='schwarz'>
$bodytag str_replace("%body%""schwarz""<body text='%body%'>");

// Liefert: Hll PHP-Wlt
$vokale = array("a""e""i""o""u""A""E""I""O""U");
$onlyconsonants str_replace($vokale"""Hallo PHP-Welt");

// Liefert: Sie sollten taeglich Pizza, Bier und Eiscreme essen.
$phrase "Sie sollten taeglich Fruechte, Gemuese und Ballaststoffe essen.";
$gesund = array("Fruechte""Gemuese""Ballaststoffe");
$lecker = array("Pizza""Bier""Eiscreme");

$newphrase str_replace($gesund$lecker$phrase);

// Liefert: 2
$str str_replace("ll""""good golly miss molly!"$count);
echo 
$count;
?>

Beispiel #2 Beispiele möglicher Probleme durch str_replace()

<?php
// Reihenfolge von Ersetzungen
$str     "Zeile 1\nZeile 2\rZeile 3\r\nZeile 4\n";
$order   = array("\r\n""\n""\r");
$replace '<br />';
// Verarbeitet \r\n's zuerst, so dass sie nicht doppelt konvertiert werden
$newstr str_replace($order$replace$str);

// Ausgabe: F da A durch B ersetzt wird, dann B durch C, und so weiter...
// Letztlich wird E durch F ersetzt, wegen der Ersetzung von Links nach Rechts
$search  = array('A''B''C''D''E');
$replace = array('B''C''D''E''F');
$subject 'A';
echo 
str_replace($search$replace$subject);

// Ausgabe: apearpearle pear
// Aus dem gleichen Grund wie oben beschrieben
$letters = array('a''p');
$fruit   = array('apple''pear');
$text    'a p';
$output  str_replace($letters$fruit$text);
echo 
$output;
?>

Anmerkungen

Hinweis: Diese Funktion ist binärsicher.

Achtung

Mögliche Probleme durch Reihenfolge der Ersetzungen

Weil str_replace() von links nach rechts ersetzt, kann ein zuvor eingesetzter Wert ersetzt werden, wenn mehrere Ersetzungen durchgeführt werden. Das letzte Beispiel zeigt, was dies für Auswirkungen hat.

Hinweis:

Die Funktion berücksichtigt Groß- und Kleinschreibung. Verwenden Sie str_ireplace(), wenn Sie unabhängig von Groß- und Kleinschreibung ersetzen möchten.

Siehe auch

  • str_ireplace() - Groß- und kleinschreibungsunabhängige Version von str_replace
  • substr_replace() - Ersetzt Text innerhalb einer Zeichenkette
  • preg_replace() - Sucht und ersetzt mit regulären Ausdrücken
  • strtr() - Tauscht Zeichen aus oder ersetzt Zeichenketten

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

DeepL Erweiterung Write als beta veröffentlicht

DeepL hat eine neuen Dienst Namens „write“ veröffentlicht, der die Rechtschreibung und Grammatik mit KI verbessern soll. ...

admin

Autor : admin
Kategorie: Dies und Das

PHPStan unterstützt PHP 8.2

PHPStan ist ein statischer Code-Analyse-Werkzeug für PHP und unterstützt jetzt PHP bis zu Version 8.2 ...

admin

Autor : admin
Kategorie: Software-Updates

xt:Commerce 6.5 für PHP 8.1 und neuem PayPal Checkout

Die Open Source Online-Shop Software xt:Commerce unterstützt in der Version 6.5 jetzt auch PHP 8.1. und stellt den Support für PHP 7.4 ein. ...

TheMax

Autor : TheMax
Kategorie: Software-Updates

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

Script führt Update aller Spalten aus anstatt nur der gewählten

Vielen lieben Dank. Das Script arbeitet jetzt perfekt. Wollte mich auch noch für all die Tipps bedanken. Habe auf POST umgestellt und übergebe d ...

Geschrieben von MattOhl am 28.01.2023 13:46:35
Forum: SQL / Datenbanken
Neuer Podcast zur Webentwicklung

Hallo zusammen, ich komme selbst aus der Webentwicklung und hatte früher den beliebtesten deutschsprachigen PHP-Blog (www.phphatesme.com). Jetzt ...

Geschrieben von SDDC am 28.01.2023 07:20:39
Forum: News / Kostenloses
Script führt Update aller Spalten aus anstatt nur der gewählten

Du brauchst gar keine Schleife beim Speichern. Wieso auch?

Geschrieben von jonas3344 am 27.01.2023 18:16:50
Forum: SQL / Datenbanken
Script führt Update aller Spalten aus anstatt nur der gewählten

Vielen Dank für Antwort. Ich bin jetzt etwas ratlos, wie ich das abändern kann, kannst Du mir eventuell ein Beispiel geben, denn while klappt es ...

Geschrieben von MattOhl am 27.01.2023 14:52:29
Forum: SQL / Datenbanken