Forum und email

preg_replace_callback

(PHP 4 >= 4.0.5, PHP 5)

preg_replace_callback — Sucht und ersetzt einen regulären Ausdruck unter Verwendung eines Callbacks

Beschreibung

mixed preg_replace_callback ( mixed $Suchmuster , callback $Callback , mixed $Zeichenkette [, int $Limit [, int &$Anzahl ]] )

Abgesehen von der Tatsache, dass statt des Parameters Ersatz ein Callback angeben werden soll, ist das Verhalten dieser Funktion identisch zu preg_replace().

Parameter Liste

Suchmuster

Der Ausdruck nach dem gesucht werden soll. Es kann entweder eine Zeichenkette oder ein Array mit Zeichenketten sein.

Callback

Ein Callback, dem ein Array von Übereinstimmungen mit Zeichenkette übergeben wird. Der Callback sollte die Ersetzungs-Zeichenkette liefern.

Häufig werden Sie die Callback -Funktion für preg_replace_callback() nur an einer Stelle benötigen. In diesem Fall können Sie create_function() verwenden, um innerhalb des Aufrufs von preg_replace_callback() eine anonyme Funktion als 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.

Example#1 preg_replace_callback() und create_function()

<?php
// ein Kommandozeilen-Filter im Unix-Stil zum Umwandeln von Groß- 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|',
    
create_function(
      
// hier sind entweder einfache Anführungszeichen nötig
      // oder alternativ die Maskierung aller $ als \$
      
'$treffer',
      
'return strtolower($treffer[0]);'
    
),
    
$zeile
  
);
  echo 
$zeile;
}
fclose($fp);
?>

Zeichenkette

Die Zeichenkette oder ein Array mit Zeichenketten zum Suchen und Ersetzen

Limit

Die Höchstzahl der Ersetzungen für jedes Suchmuster in jeder Zeichenkette . Standardmäßig -1 (unbegrenzt).

Anzahl

Falls angegeben, wird dieser Variable die Anzahl vorgenommener Ersetzungen zugewiesen.

Rückgabewerte

Falls Zeichenkette ein Array ist, gibt preg_replace_callback() ein Array zurück und andernfalls eine Zeichenkette.

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

ChangeLog

Version Beschreibung
5.1.0 Den Parameter Anzahl hinzugefügt

Beispiele

Example#2 preg_replace_callback() Beispiel

<?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);

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Aprilscherze gibts am 01.04.2003
Das letzte Weihnachten war am 24.12.2002

Example#3 preg_replace_callback() unter Verwendung einer rekursiven Struktur um gekapselten BB-Code zu verarbeiten

<?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;
?>

Siehe auch