Dislaimer | Kontakt | Sitemap

Hintergrund

Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

preg_replace_callback
PCRE-Funktionen

    Befehl:
mixed preg_replace_callback ( mixed $pattern , callable $callback , mixed $subject [, int $limit = -1 [, int &$count ]] )


    Parameter-Liste:
NameBeschreibung
patternDer Ausdruck, nach dem gesucht werden soll. Es kann entweder eine Zeichenkette oder ein Array mit Zeichenketten sein.
callbackEin Callback, dem ein Array von Übereinstimmungen mit subject übergeben wird. Der Callback sollte die Ersetzungs-Zeichenkette liefern. Das ist die Callback-Signatur:
string handler ( array $matches )

Häufig werden Sie die callback-Funktion für preg_replace_callback() nur an einer Stelle benötigen. In diesem Fall können Sie eine Anonyme Funktion verwenden, um innerhalb des Aufrufs von preg_replace_callback() den Callback zu deklarieren. Auf diese Weise haben Sie alle Informationen für den Aufruf an einer Stelle und stopfen den Namensraum für Funktionen nicht mit Namen für Callback-Funktionen voll, die sonst nirgends verwendet werden.


Beispiel #1 preg_replace_callback() und Anonyme Funktion
<?php
// ein Kommandozeilen-Filter im Unix-Stil zum Umwandeln von Gross- in
// Kleinschreibung am Beginn eines Abschnitts
$fp = fopen("php://stdin", "r") or die("kann stdin nicht lesen");
while (!feof($fp)) {
  $zeile = fgets($fp);
  $zeile = preg_replace_callback(
    '|<p>\s*\w|',
    function ($treffer) {
      return strtolower($treffer[0]);
    },
    $zeile
  );
  echo $zeile;
}
fclose($fp);
?>
subjectDie Zeichenkette oder ein Array mit Zeichenketten zum Suchen und Ersetzen.
limitDie Höchstzahl der Ersetzungen für jedes Suchmuster in jeder subject. Standardmässig -1 (unbegrenzt).
countFalls angegeben, wird dieser Variable die Anzahl vorgenommener Ersetzungen zugewiesen.

    Rückgabewerte:
Falls subject ein Array ist, gibt preg_replace_callback() ein Array zurück und andernfalls eine Zeichenkette. Bei einem Fehler ist der Rückgabewert NULL.

Falls Übereinstimmungen gefunden werden, wird die neue Zeichenkette zurückgegeben und andernfalls die unveränderte Zeichenkette subject.

    Beschreibung:
Abgesehen von der Tatsache, dass statt des Parameters replacement ein callback angegeben werden soll, ist das Verhalten dieser Funktion identisch zu preg_replace().


    Aktiv in Version:
(PHP 4 >= 4.0.5, PHP 5, PHP 7)

    Siehe auch:
•  preg_replace()
Sucht und ersetzt mit regulären Ausdrücken
 
•  preg_last_error()
Liefert den Fehlercode der letzten PCRE RegEx-Auswertung
 

preg_replace_callback() - Beispiel:

Eingabe: 
<?PHP
// dieser Text wurde 2002 verwendet
// wir wollen ihn für 2003 aktualisieren
$text = "Aprilscherze gibts am 01.04.2002\n";
$text.= "Das letzte Weihnachten war am 24.12.2001\n";
// die Callback-Funktion
function naechstes_jahr($treffer)
{
  // wie üblich: $treffer[0] ist die Übereinstimmung mit dem
  // kompletten Suchmuster, $treffer[1] die Übereinstimmung mit
  // dem ersten eingeklammerten Teilsuchmuster und so weiter
  return $treffer[1].($treffer[2]+1);
}
echo preg_replace_callback(
            "|(\d{2}\.\d{2}\.)(\d{4})|",
            "naechstes_jahr",
            $text);
?>


Ausgabe:
Aprilscherze gibts am 01.04.2024
Das letzte Weihnachten war am 24.12.2023

Beschreibung:
Version Beschreibung
5.1.0 Den Parameter count hinzugefügt
preg_replace_callback() - Beispiel 2 :unter Verwendung einer rekursiven Struktur um gekapselten BB-Code zu verarbeiten

Eingabe: 
<?PHP
$eingabe = "plain [indent] deep [indent] deeper [/indent] deep [/indent] plain";

function parseTagsRecursive($eingabe)
{
  $regex = '#\[indent]((?:[^[]|\[(?!/?indent])|(?R))+)\[/indent]#';

  if (is_array($eingabe)) {
    $eingabe = '<div style="margin-left: 10px">'.$eingabe[1].'</div>';
  }

  return preg_replace_callback($regex, 'parseTagsRecursive', $eingabe);
}

$ausgabe = parseTagsRecursive($eingabe);

echo $ausgabe;
?>


Beschreibung:
Version Beschreibung
5.1.0 Den Parameter count hinzugefügt
preg_replace_callback_array
PCRE-Funktionen