cvs: phpdoc-de /reference/pcre/functions preg-quote.xml preg-replace-callback.xml
| From: | Martin Samesch | Date: | Mon, 10 May 2004 09:11:27 +0000 |
| Subject: | cvs: phpdoc-de /reference/pcre/functions preg-quote.xml preg-replace-callback.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-1150@lists.php.net to get a copy of this message | ||
samesch Mon May 10 05:11:27 2004 EDT
Added files:
/phpdoc-de/reference/pcre/functions preg-quote.xml
preg-replace-callback.xml
Log:
added; initial translation
http://cvs.php.net/co.php/phpdoc-de/reference/pcre/functions/preg-quote.xml?r=1.1&p=1
Index: phpdoc-de/reference/pcre/functions/preg-quote.xml
+++ phpdoc-de/reference/pcre/functions/preg-quote.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready -->
<!-- splitted from ./en/functions/pcre.xml, last change in rev 1.2 -->
<refentry id="function.preg-quote">
<refnamediv>
<refname>preg_quote</refname>
<refpurpose>Maskiert Zeichen regulärer Ausdrücke</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<methodsynopsis>
<type>string</type><methodname>preg_quote</methodname>
<methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>Begrenzer</parameter></methodparam>
</methodsynopsis>
<para>
<function>preg_quote</function> setzt einen Backslash vor jedes Zeichen
von <parameter>Zeichenkette</parameter>, das zur Syntax eines regulären
Ausdrucks gehört. Das ist nützlich, wenn Sie einen Text nach
Übereinstimmungen mit einer zur Laufzeit erzeugten Zeichenkette
durchsuchen müssen, die spezielle Regex-Zeichen enthalten könnte.
</para>
<para>
Falls der optionale <parameter>Begrenzer</parameter> angegeben wurde,
wird dieser ebenfalls maskiert. Das ist nützlich, um den Begrenzer zu
maskieren, der von den PCRE-Funktionen benötigt wird. Der / ist der am
häufigsten verwendete Begrenzer.
</para>
<para>
Spezielle Zeichen regulärer Ausdrücke sind:
<literal>. \\ + * ? [ ^ ] $ ( ) { } = ! < > | :</literal>
</para>
<para>
<example>
<title><function>preg_quote</function> Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
$schluesselwoerter = "$40 für einen G3/400";
$schluesselwoerter = preg_quote($schluesselwoerter, "/");
echo $schluesselwoerter; // liefert \$40 für einen G3\/400
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Kursivdruck eines Wortes in einem Text</title>
<programlisting role="php">
<![CDATA[
<?php
// In diesem Beispiel wird preg_quote($wort) verwendet,
// damit die Asterisks (*) für den regulären Ausdruck
// keine spezielle Bedeutung haben.
$text = "Dieses Buch ist *sehr* schwer zu finden.";
$wort = "*sehr*";
$text = preg_replace ("/" . preg_quote($wort) . "/",
"<i>" . $wort . "</i>",
$text);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/co.php/phpdoc-de/reference/pcre/functions/preg-replace-callback.xml?r=1.1&p=1
Index: phpdoc-de/reference/pcre/functions/preg-replace-callback.xml
+++ phpdoc-de/reference/pcre/functions/preg-replace-callback.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready -->
<!-- splitted from ./en/functions/pcre.xml, last change in rev 1.47 -->
<refentry id="function.preg-replace-callback">
<refnamediv>
<refname>preg_replace_callback</refname>
<refpurpose>
Sucht und ersetzt einen regulären Ausdruck unter Verwendung eines
Callbacks
</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<methodsynopsis>
<type>mixed</type><methodname>preg_replace_callback</methodname>
<methodparam><type>mixed</type><parameter>Suchmuster</parameter></methodparam>
<methodparam><type>callback</type><parameter>Callback</parameter></methodparam>
<methodparam><type>mixed</type><parameter>Zeichenkette</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>Limit</parameter></methodparam>
</methodsynopsis>
<para>
Abgesehen von der Tatsache, dass statt des Parameters
<parameter>Ersatz</parameter> ein <parameter>Callback</parameter>
angeben werden soll, dem ein Array von Übereinstimmungen mit der
durchsuchten Zeichenkette übergeben wird, ist das Verhalten dieser
Funktion identisch zu <function>preg_replace</function>. Der Callback
sollte die Ersetzungs-Zeichenkette liefern.
</para>
<example>
<title><function>preg_replace_callback</function> Beispiel</title>
<programlisting role='php'>
<![CDATA[
<?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 Teil-Suchmuster und so weiter
return $treffer[1].($treffer[2]+1);
}
echo preg_replace_callback(
"|(\d{2}/\d{2}/)(\d{4})|",
"naechstes_jahr",
$text);
// das Ergebnis:
// Aprilscherze gibts am 01.04.2003
// Das letzte Weihnachten war am 24.12.2002
?>
]]>
</programlisting>
</example>
<para>
Häufig werden Sie die <parameter>Callback</parameter>-Funktion für
<function>preg_replace_callback</function> nur an einer Stelle benötigen.
In diesem Fall können Sie <function>create_function</function> verwenden,
um innerhalb des Aufrufs von <function>preg_replace_callback</function>
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.
</para>
<example>
<title>
<function>preg_replace_callback</function> und
<function>create_function</function>
</title>
<programlisting role='php'>
<![CDATA[
<?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);
?>
]]>
</programlisting>
</example>
<para>
Siehe auch <function>preg_replace</function> und
<function>create_function</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->