WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

preg_replace()

Ersetzt Treffer durch Text mit Verweisen auf nummerierte Gruppen.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

preg_replace(string|array $pattern, string|array $replacement, string|array $subject, int $limit = -1, int &$count = null): string|array|null

Ersetzt Treffer durch Text mit Verweisen auf nummerierte Gruppen. Geschweifte Klammern trennen die Gruppennummer von folgenden Ziffern. Das Limit gilt pro Muster und Eingabetext. count erhält die Gesamtzahl der Ersetzungen. Ein Musterkompilierungsfehler liefert für eine Zeichenkette null und für ein Array mit einer Zeichenkette ein leeres Array.

Signatur

preg_replace(string|array $pattern, string|array $replacement, string|array $subject, int $limit = -1, int &$count = null): string|array|null

Ausgabe des Beispiels

["A0-12 B7",1]
[null,[]]

Beispiele

<?php
$out=preg_replace("~([A-Z])(\\d+)~",'${1}0-$2',"A12 B7",1,$n);
echo json_encode([$out,$n]);
set_error_handler(fn($level)=>$level===E_WARNING); $a=preg_replace("~[~","","x"); $b=preg_replace("~[~","",["x"]); restore_error_handler(); echo "\n",json_encode([$a,$b]);

Ergebnis

["A0-12 B7",1]
[null,[]]

Quellen