str_replace - Český PHP manuál

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

Parametry

Řetězec, podřetězec který nahrazujeme a nakonec podřetězec, kterým nahrazujeme. Zkráceně co nahradit, čím a kde. Pokud uvedeme v nepovinném 4. parametru proměnnou, bude do ní uloženo kolik nahrazení proběhlo.

Podřetězce můžeme uvést i v polích, jak si ukážeme v příkladu.

Návratová hodnota

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

Příklad

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

Výstup:

PHP je nejlepší nástroj pro dynamické weby. Ať žije PHP!

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:

Příklad

<?php
    $co = array(':)', ':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');

Výstup:

Ahoj <img src="usmev.png" alt="úsměv" /> Je mi fajn, protože jsem objevil ITnetwork <img src="smich.png" alt="smích" />'

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.

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.