PHP preg_replace() Functie
Voorbeeld
Gebruik een hoofdletterongevoelige reguliere expressie om Microsoft te vervangen door W3Schools in een tekenreeks:
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
Definitie en gebruik
De preg_replace()
functie retourneert een tekenreeks of reeks tekenreeksen waarbij alle overeenkomsten van een patroon of lijst met patronen die in de invoer worden gevonden, worden vervangen door subtekenreeksen.
Er zijn drie verschillende manieren om deze functie te gebruiken:
1. Eén patroon en een vervangende snaar. Overeenkomsten van het patroon worden vervangen door de vervangende string.
2. Een reeks patronen en een vervangende string. Komt overeen met een van de patronen, wordt vervangen door de vervangende tekenreeks.
3. Een reeks patronen en een reeks vervangende tekenreeksen. Overeenkomsten van elk patroon worden vervangen door de vervangende string op dezelfde positie in de vervangingsreeks. Als er op die positie geen item wordt gevonden, wordt de overeenkomst vervangen door een lege string.
Vervangende strings kunnen een terugverwijzing bevatten in de vorm \n of $n waarbij n de index is van een groep in het patroon. In de geretourneerde tekenreeks worden instanties van \n en $n vervangen door de subtekenreeks die overeenkomt met de groep of, als \0 of $0 wordt gebruikt, door de hele uitdrukking.
Opmerking: voor elke invoerreeks evalueert de functie de patronen in de volgorde waarin ze zijn gegeven. Het resultaat van het evalueren van het eerste patroon op de tekenreeks wordt gebruikt als invoertekenreeks voor het tweede patroon, enzovoort. Dit kan leiden tot onverwacht gedrag.
Syntaxis
preg_replace(patterns, replacements, input, limit, count)
Parameterwaarden
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 |
Technische details
Winstwaarde: | Retourneert een tekenreeks of een reeks tekenreeksen die het resultaat zijn van het toepassen van de vervangingen op de invoertekenreeks of tekenreeksen |
---|---|
PHP-versie: | 4.0.5+ |
Wijzigingslogboek: | PHP 5.1.0 - De count-parameter is toegevoegd |
❮ PHP RegExp-referentie