Funkce PHP preg_replace().
❮ Referenční příručka PHP RegExp
Příklad
Použijte regulární výraz bez rozlišení velkých a malých písmen k nahrazení společnosti Microsoft výrazem W3Schools v řetězci:
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
Definice a použití
Funkce preg_replace() vrací řetězec nebo pole řetězců, kde jsou všechny shody vzoru nebo seznamu vzorů nalezených na vstupu nahrazeny podřetězci.
Tuto funkci lze použít třemi různými způsoby:
1. Jeden vzor a náhradní řetězec. Shody vzoru jsou nahrazeny náhradním řetězcem.
2. Pole vzorů a náhradní řetězec. Odpovídající některý ze vzorů jsou nahrazeny náhradním řetězcem.
3. Pole vzorů a pole náhradních řetězců. Shody každého vzoru jsou nahrazeny náhradním řetězcem na stejné pozici v poli náhrad. Pokud na této pozici není nalezena žádná položka, shoda je nahrazena prázdným řetězcem.
Náhradní řetězce mohou obsahovat zpětný odkaz ve tvaru \n nebo $n, kde n je index skupiny ve vzoru. Ve vráceném řetězci budou instance \n a $n nahrazeny podřetězcem, který odpovídal skupině nebo, pokud jsou použity \0 nebo $0, celým výrazem.
Poznámka: Pro každý vstupní řetězec funkce vyhodnocuje vzory v pořadí, v jakém jsou zadány. Výsledek vyhodnocení prvního vzoru na řetězci se použije jako vstupní řetězec pro druhý vzor a tak dále. To může vést k neočekávanému chování.
Syntax
preg_replace(patterns, replacements, input, limit, count)
Hodnoty parametrů
| Parameter | Description |
|---|---|
| patterns | Required. Contains a regular expression or array of regular expressions |
| replacements | Required. A replacement string or an array of replacement strings |
| input | Required. The string or array of strings in which replacements are being performed |
| limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
| count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
Technické údaje
| Návratová hodnota: | Vrátí řetězec nebo pole řetězců vyplývající z použití náhrad na vstupní řetězec nebo řetězce |
|---|---|
| Verze PHP: | 4.0.5+ |
| Seznam změn: | PHP 5.1.0 - Byl přidán parametr count |
❮ Referenční příručka PHP RegExp