PHP - str_replace

Třída

Kořen \ Bez třídy

Metoda - str_replace

(PHP 4, PHP 5, PHP 7)

Nahradí všechny výskyty podřetězce v řetězci daným podřetězcem.

Vyhledávání probíhá zleva doprava, s tím musíme počítat, občas může dojít k nahrazení již nahrazených znaků. Pokud bychom chtěli vyhledávat bez ohledu na velká a malá písmena, použijeme funkci str_ireplace().

Procedurální

• function str_replace (mixed $search, mixed $replace, mixed $subject, int &$count) : mixed

Parametry

Název	Datový typ	Výchozí hodnota	Popis
$search	mixed		Podřetězec, který se hledá. Lze uvést pole.
$replace	mixed		Podřetězec, kterým se nahrazuje. Lze uvést pole.
$subject	mixed		Řetězec, ve kterým se má nahrazovat.
&$count	int		Pokud uvedeme v tomto nepovinném parametru proměnnou, bude do ní uloženo, kolik nahrazení proběhlo.

Návratové hodnoty

Vrací: mixed

Funkce vrací podřetězec po provedení nahrazení.

Příklady

<?php
echo str_replace('ASP.NET', 'PHP', 'ASP.NET je nejlepší nástroj pro dynamické weby. Ať žije ASP.NET!');

Pokud uvedeme podřetězce v polích, nahradí se vždy příslušná hodnota v prvním poli hodnotou v druhém poli. Udělejme si příklad:

<?php
$co = [':)', ':D'];
$cim = array('<img src="usmev.png" alt="úsměv" />', '<img src="smich.png" alt="smích" />');
echo str_replace($co, $cim, 'Ahoj :) Je mi fajn, protože jsem objevil ITnetwork :D');

Vidíte, že funkci lze použít např. k nahrazení textových smajlíků v textu za obrázkové. str_replace() patří mezi nejpoužívanější funkce pro práci s řetězci.