cvs: phpdoc-de /reference/pcre/functions preg-match.xml

From: Date: Sat, 08 May 2004 14:31:19 +0000
Subject: cvs: phpdoc-de /reference/pcre/functions preg-match.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-1149@lists.php.net to get a copy of this message
samesch Sat May 8 10:31:19 2004 EDT Added files: /phpdoc-de/reference/pcre/functions preg-match.xml Log: added; initial translation http://cvs.php.net/co.php/phpdoc-de/reference/pcre/functions/preg-match.xml?r=1.1&p=1 Index: phpdoc-de/reference/pcre/functions/preg-match.xml +++ phpdoc-de/reference/pcre/functions/preg-match.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.12 Maintainer: samesch Status: ready --> <!-- splitted from ./en/functions/pcre.xml, last change in rev 1.2 --> <refentry id="function.preg-match"> <refnamediv> <refname>preg_match</refname> <refpurpose> Führt eine Suche mit einem regulären Ausdruck durch </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>preg_match</methodname> <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>Treffer</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>Flags</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>Versatz</parameter></methodparam> </methodsynopsis> <para> Durchsucht <parameter>Zeichenkette</parameter> nach Übereinstimmungen mit dem in <parameter>Suchmuster</parameter> angegebenen regulären Ausdruck. </para> <para> Falls der Parameter <parameter>Treffer</parameter> angegeben wurde, wird er mit den Suchergebnissen gefüllt. <varname>$treffer[0]</varname> enthält dann den Text, der mit dem kompletten Suchmuster übereinstimmt, <varname>$treffer[1]</varname> den Text, der mit dem ersten eingeklammerten Teil-Suchmuster übereinstimmt und so weiter. </para> <para> <parameter>Flags</parameter> kann das folgende Flag sein: <variablelist> <varlistentry> <term>PREG_OFFSET_CAPTURE</term> <listitem> <simpara> Wenn dieses Flag gesetzt ist, wird mit jeder gefundenen Übereinstimmung der dazugehörige Versatz in der Zeichenkette zurückgegeben. Beachten Sie, dass dies die Rückgabewerte in einem Array dahingehend ändert, dass jedes Element ein Array ist, das aus der übereinstimmenden Zeichenkette als Element <literal>0</literal> und deren Stelle in der durchsuchten Zeichenkette als Element <literal>1</literal> besteht. Dieses Flag steht seit PHP 4.3.0 zur Verfügung. </simpara> </listitem> </varlistentry> </variablelist> Der Parameter <parameter>Flags</parameter> steht seit PHP 4.3.0. zur Verfügung. </para> <para> Normalerweise beginnt die Suche am Anfang der Zeichenkette. Der optionale Parameter <parameter>Versatz</parameter> kann verwendet werden, um eine andere Stelle anzugeben, ab der gesucht werden soll. Es ist der Übergabe von <function>substr</function>($zeichenkette, $versatz) an Stelle der Zeichenkette an <function>preg_match</function> gleichwertig. Der Parameter <parameter>Versatz</parameter> steht seit PHP 4.3.3 zur Verfügung. </para> <para> <function>preg_match</function> gibt die Anzahl der Übereinstimmungen mit <parameter>Suchmuster</parameter> zurück. Das ist entweder 0 (keine Übereinstimmung) oder 1, weil <function>preg_match</function> die Suche nach der ersten Übereinstimmung beendet. Im Gegensatz dazu setzt <function>preg_match_all</function> die Suche bis zum Ende von <parameter>Zeichenkette</parameter> fort. <function>preg_match</function> gibt &false; zurück, falls ein Fehler auftrat. </para> <tip> <para> Verwenden Sie nicht <function>preg_match</function>, wenn Sie nur überprüfen wollen, ob eine Zeichenkette in einer anderen Zeichenkette enthalten ist. Verwenden Sie dafür stattdessen die Funktionen <function>strpos</function> oder <function>strstr</function>, die das schneller erledigen. </para> </tip> <para> <example> <title>Die Zeichenkette "php" finden</title> <programlisting role="php"> <![CDATA[ <?php // Das "i" nach der Suchmuster-Begrenzung kennzeichnet eine Suche ohne // Berücksichtigung von Groß- und Kleinschreibung if (preg_match("/php/i", "PHP ist die Web-Scripting-Sprache der Wahl.")) { echo "Es wurde eine Übereinstimmung gefunden."; } else { echo "Es wurde keine Übereinstimmung gefunden."; } ?> ]]> </programlisting> </example> </para> <para> <example> <title>Die Zeichenkette "web" finden</title> <programlisting role="php"> <![CDATA[ <?php // Das \b im Suchmuster kennzeichnet eine Wortgrenze, weshalb nur // eine Übereinstimmung mit der einzelnen Zeichenkette "web" gefunden wird und // nicht ein Teilwort in "webbing" oder "cobweb" if (preg_match("/\bweb\b/i", "Für das Web ist PHP die Scripting-Sprache der Wahl.")) { echo "Es wurde eine Übereinstimmung gefunden."; } else { echo "Es wurde keine Übereinstimmung gefunden."; } if (preg_match("/\bweb\b/i", "PHP ist die Web-Scripting-Sprache der Wahl.")) { echo "Es wurde eine Übereinstimmung gefunden."; } else { echo "Es wurde keine Übereinstimmung gefunden."; } ?> ]]> </programlisting> </example> </para> <para> <example> <title>Den Domänen-Namen aus einer URL holen</title> <programlisting role="php"> <![CDATA[ <?php // den Hostnamen aus URL holen preg_match("/^(http:\/\/)?([^\/]+)/i", "http://www.php.net/index.html", $treffer); $host = $treffer[2]; // die letzten beiden Segmente aus Hostnamen holen preg_match("/[^\.\/]+\.[^\.\/]+$/", $host, $treffer); echo "Der Domänen-Name lautet: {$treffer[0]}\n"; ?> ]]> </programlisting> <para> Dieses Beispiel erzeugt: </para> <screen> <![CDATA[ Der Domänen-Name lautet: php.net ]]> </screen> </example> </para> <para> Siehe auch <function>preg_match_all</function>, <function>preg_replace</function> und <function>preg_split</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 -->

« previous php.doc.de (#1149) next »