<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.regex">
  <title>Regulre Ausdrcke Funktionen (POSIX erweitert)</title>
  <titleabbrev>Regexps</titleabbrev>

  <partintro>
   <note>
    <para>
     Bei Verwendung der <link linkend="ref.pcre">PCRE
     Funktionen</link> untersttzt PHP auch Regulre Ausdrcke mit
     einer zu Perl kompatiblen Syntax. Diese Funktionen untersttzen
     non-greedy Matching, Assertions, bedingte Subpatterns und viele
     andere Merkmale, die von der POSIX-erweiterten Syntax regulrer
     Ausdrcke nicht untersttzt werden.
    </para>
   </note>
   <warning>
    <para>
     Diese Funktionen regulrer Ausdrcke sind im Gegensatz zu den
     <link linkend="ref.pcre">PCRE Funktionen</link> nicht
     binary-safe.
    </para>
   </warning>
   <para>
    Regulre Ausdrcke werden fr komplexe Manipulationen an
    Zeichenketten mit PHP verwendet. Folgende Funktionen untersttzen
    regulre Ausdrcke:
    <itemizedlist>
     <listitem>
      <simpara><function>ereg</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>ereg_replace</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>eregi</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>eregi_replace</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>split</function></simpara>
     </listitem>
     <listitem>
      <simpara><function>spliti</function></simpara>
     </listitem>
    </itemizedlist>
    Alle diese Funktionen nehmen als erstes Argument einen regulren
    Ausdruck an. PHP verwendet durch POSIX 1003.2 definierte POSIX
    erweiterte regulre Ausdrcke. Eine vollstndige Beschreibung der
    POSIX regulren Ausdrcke finden Sie im Regex-Verzeichnis der
    PHP-Distribution in den Regex man pages.  Da sie im manpage-Fomat
    vorliegt, sollten Sie einen Befehl der Art <command> man
    /usr/local/src/regex/regex.7</command> verwenden, um sie zu lesen.
   </para>
   <para>
    <example>
     <title>Beispiele regulrer Ausdrcke</title>
     <programlisting role="php">
<![CDATA[
ereg ("abc", $string);            
/* Gibt true zurck, falls "abc"
   irgendwo in $string gefunden wird. */

ereg ("^abc", $string);
/* Gibt true zurck, falls "abc"
   am Anfang von $string gefunden wird. */

ereg ("abc$", $string);
/* Gibt true zurck, falls "abc"
   am Ende von $string gefunden wird. */

eregi ("(ozilla.[23]|MSIE.3)", $HTTP_USER_AGENT);  
/* Gibt true zurck, falls es sich beim Client Browser
   um Netscape 2, 3 oder MSIE 3 handelt. */

ereg ("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)", $string,$regs); 
/* Setzt drei Wrter, die durch Leerzeichen getrennt
   sind, in $regs[1], $regs[2] und $regs[3] ein. */

$string = ereg_replace ("^", "<br />", $string); 
/* Setzt ein <br /> Tag vor $string. */ 

$string = ereg_replace ("$", "<br />", $string); 
/* Setzt ein <br /> Tag hinter $string. */

$string = ereg_replace ("\n", "", $string);
/* Entfernt alle Zeilenumbrche aus $string. */
]]>
     </programlisting>
    </example>
   </para>
  </partintro>

  <refentry id="function.ereg">
   <refnamediv>
    <refname>ereg</refname>
    <refpurpose>
     Sucht bereinstimmungen mit einem regulren Ausdruck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ereg</methodname>
      <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam>
      <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam>
     </methodsynopsis>
    <note>
     <para>
      Die Funktion <function>preg_match</function>, die eine zu Perl
      kompatible Syntax regulrer Ausdrcke verwendet, ist hufig die
      schnellere Alternative zu <function>ereg</function>.
     </para>
    </note>
    <simpara>
     Sucht in <parameter>Zeichenkette</parameter> nach
     bereinstimmungen mit dem regulren Ausdruck, der in
     <parameter>Suchmuster</parameter> angegeben wurde.
    </simpara>
    <simpara>
     Wenn bereinstimmungen mit eingeklammerten Teilzeichenketten von
     <parameter>Suchmuster</parameter> gefunden werden und die
     Funktion mit dem dritten Argument <parameter>regs</parameter>
     aufgerufen wurde, werden die bereinstimmungen in den Elementen
     des Arrays <parameter>regs</parameter> gespeichert. $regs[1]
     enthlt dann die Teilzeichenkette der ersten Klammer, $regs[2]
     die Teilzeichenkette der zweiten usw. $regs[0] enthlt bei
     bereinstimmung mit <parameter>Zeichenkette</parameter> eine
     Kopie der kompletten <parameter>Zeichenkette</parameter>.
    </simpara>
    <simpara>
     Bis (und inklusive) PHP 4.1.0 wird <literal>$regs</literal> mit
     genau zehn Elementen gefllt, auch wenn es tatschlich mehr oder
     weniger bereinstimmungen mit den eingeklammerten
     Teilzeichenketten gibt. Dies wirkt sich aber nicht auf
     <function>ereg</function>s Fhigkeit aus, mehr bereinstimmende
     Teilzeichenketten zu finden. Falls keine bereinstimmungen
     gefunden werden, wird <literal>$regs</literal> nicht von
     <function>ereg</function> verndert.
    </simpara>
    <simpara>
     Die Suche unterscheidet zwischen Gro und Kleinschreibung.
    </simpara>
    <simpara>
     Gibt &true; zurck, wenn in <parameter>Zeichenkette</parameter>
     eine bereinstimmung mit <parameter>Suchmuster</parameter>
     gefunden wurde oder &false;, wenn keine bereinstimmung gefunden
     wurde oder wenn ein Fehler aufgetreten ist.
    </simpara>
    <para>
     Der folgende Code-Schnipsel mimmt ein Datum im ISO-Format
     (JJJJ-MM-TT) und gibt es im Format TT.MM.JJJJ aus:
     <example>
      <title><function>ereg</function> Beispiel</title>
      <programlisting role="php">
<![CDATA[
if (ereg ("([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $date, $regs)) {
    echo "$regs[3].$regs[2].$regs[1]";
} else {
    echo "Ungltiges Datumsformat: $date";
}
]]>
      </programlisting>
     </example>
    </para>
    <simpara>
     Siehe auch: <function>eregi</function>,
     <function>ereg_replace</function>,
     <function>eregi_replace</function> und
     <function>preg_match</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.ereg-replace">
   <refnamediv>
    <refname>ereg_replace</refname>
    <refpurpose>Ersetzt einen regulren Ausdruck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>ereg_replace</methodname>
      <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam>
      <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam>
      <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam>
     </methodsynopsis>
    <note>
     <para>
      Die Funktion <function>preg_replace</function>, die eine zu Perl
      kompatible Syntax regulrer Ausdrcke verwendet, ist hufig die
      schnellere Alternative zu <function>ereg_replace</function>.
     </para>
    </note>
    <simpara>
     Diese Funktion durchsucht <parameter>Zeichenkette</parameter>
     nach bereinstimmungen mit <parameter>Suchmuster</parameter> und
     ersetzt dann den bereinstimmenden Text durch
     <parameter>Ersatz</parameter>.
    </simpara>
    <simpara>
     Zurckgegeben wird die genderte Zeichenkette, was auch bedeuten
     knnte, dass die ursprngliche Zeichenkette zurckgegeben wird,
     wenn es keine zu ersetzenden bereinstimmungen gibt.
    </simpara>
    <simpara>
     Wenn <parameter>Suchmuster</parameter> eingeklammerte
     Teilzeichenketten enthlt, darf <parameter>Ersatz</parameter>
     Teilzeichenketten der Form
     <literal>\\<replaceable>Ziffer</replaceable></literal> enthalten,
     die dann durch die Ziffer'ste Teilzeichenkette ersetzt werden.
     <literal>\\0</literal> erzeugt den gesamten Inhalt der
     durchsuchten Zeichenkette. Bis zu neun Teilzeichenketten drfen
     verwendet werden.  Klammern drfen geschachtelt werden und werden
     in diesem Fall anhand der ffnenden Klammern gezhlt.
    </simpara>  
    <simpara>
     Wenn in <parameter>Zeichenkette</parameter> keine
     bereinstimmungen gefunden werden, wird
     <parameter>Zeichenkette</parameter> unverndert zurckgegeben.
    </simpara>
    <para>
     Der folgende Code-Schnipsel gibt zum Beispiel dreimal "Das war
     ein Test" aus:
     <example>
      <title><function>ereg_replace</function> Beispiel</title>
      <programlisting>
<![CDATA[
$string = "Das ist ein Test";
echo ereg_replace (" ist", " war", $string);
echo ereg_replace ("( )ist", "\\1war", $string);
echo ereg_replace ("(( )ist)", "\\2war", $string);
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Folgendes ist zu beachten: Wenn Sie als
     <parameter>Ersatz</parameter> einen ganzzahligen Wert verwenden,
     bekommen sie vielleicht nicht das erwartete Ergebnis. Das liegt
     daran, dass <function>ereg_replace</function> die Zahl als
     Ordinalwert eines Zeichens betrachtet und dieses verwendet. Zum
     Beispiel:
     <example>
      <title><function>ereg_replace</function> Beispiel</title>
      <programlisting>
<![CDATA[
<?php
/* Dieses funktioniert nicht wie erwartet. */
$zahl = 4;
$zeichenkette = "Diese Zeichenkette hat vier Wrter.";
$zeichenkette = ereg_replace('vier', $zahl, $zeichenkette);
echo $zeichenkette;   /* Ausgabe: 'Diese Zeichenkette hat   Wrter.' */

/* Dieses funktioniert. */
$zahl = '4';
$zeichenkette = "Diese Zeichenkette hat vier Wrter.";
$zeichenkette = ereg_replace('vier', $zahl, $zeichenkette);
echo $zeichenkette;   /* Output: 'Diese Zeichenkette hat 4 Wrter.' */
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>Ersetzen von URLs durch Links</title>
      <programlisting role="php">
<![CDATA[
$text = ereg_replace("[[:alpha:]]+://[^<>[:space:]]+[[:alnum:]/]",
                     "<a href=\"\\0\">\\0</a>", $text);
]]>
      </programlisting>
     </example>
    </para>
    <simpara>
     Siehe auch: <function>ereg</function>,
     <function>eregi</function>, <function>eregi_replace</function>,
     <function>str_replace</function> und
     <function>preg_match</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.eregi">
   <refnamediv>
    <refname>eregi</refname>
    <refpurpose>
     Sucht bereinstimmung mit regulrem Ausdruck ohne
     Bercksichtigung von Gro-/Kleinschreibung
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>eregi</methodname>
      <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam>
      <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion entspricht <function>ereg</function> mit dem
     Unterschied, dass sie bereinstimmende Buchstaben nicht nach
     Gro- und Kleinschreibung unterscheidet.
     <example>
      <title><function>eregi</function> Beispiel</title>
      <programlisting role="php">
<![CDATA[
if (eregi("z", $string)) {
    echo "'$string' contains a 'z' or 'Z'!";
}
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch: <function>ereg</function>,
     <function>ereg_replace</function> und
     <function>eregi_replace</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.eregi-replace">
   <refnamediv>
    <refname>eregi_replace</refname>
    <refpurpose>
     Ersetzt einen regulren Ausdrck ohne Bercksichtigung von
     Gro-/Kleinschreibung
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>eregi_replace</methodname>
      <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam>
      <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam>
      <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion entspricht <function>ereg_replace</function> mit
     dem Unterschied, dass sie bereinstimmende Buchstaben nicht nach
     Gro- und Kleinschreibung unterscheidet.
    </para>
    <para>
     Siehe auch: <function>ereg</function>, <function>eregi</function>
     und <function>ereg_replace</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.split">
   <refnamediv>
    <refname>split</refname>
    <refpurpose>
     Zerlegt eine Zeichenkette anhand eines regulren Ausdrucks in ein
     Array
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>split</methodname>
      <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam>
      <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>Beschrnkung</parameter></methodparam>
     </methodsynopsis>
    <note>
     <para>
      Die Funktion <function>preg_split</function>, die eine zu Perl
      kompatible Syntax regulrer Ausdrcke verwendet, ist hufig die
      schnellere Alternative zu <function>split</function>.
     </para>
    </note>
    <para>
     Gibt ein Array mit Zeichenketten zurck, die jeweils eine
     Teilzeichenkette von <parameter>Zeichenkette</parameter> sind und
     durch deren Zerlegung an den durch
     <parameter>Suchmuster</parameter> des regulren Ausdrucks
     bestimmten Stellen entstehen. Wenn
     <parameter>Beschrnkung</parameter> gesetzt wurde, enthlt das
     zurckgegebene Array hchstens
     <parameter>Beschrnkung</parameter> Elemente, von denen das
     letzte den ganzen Rest von <parameter>Zeichenkette</parameter>
     enthlt. Bei Auftreten eines Fehlers gibt
     <function>split</function> &false; zurck.
    </para>
    <para>
     Um die ersten vier Felder einer Zeile von
     <filename>/etc/passwd</filename> abzuspalten:
     <example>
      <title><function>split</function> Beispiel</title>
      <programlisting role="php">
<![CDATA[
list($user,$pass,$uid,$gid,$extra)= split (":", $passwd_line, 5);
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <simpara>
      Wenn <parameter>Suchmuster</parameter>
      <replaceable>n</replaceable> mal vorkommt, enhlt das
      zurckgegebene Array
      <literal><replaceable>n</replaceable>+1</literal> Elemente.
      Kommt <parameter>Suchmuster</parameter> zum Beispiel berhaupt
      nicht vor, wird ein Array mit nur einem Element zurckgegeben.
      Das gilt natrlich auch, wenn
      <parameter>Zeichenkette</parameter> leer ist.
     </simpara>
    </note>
    <para>
     Um ein Datum zu analysieren, das durch Schrgstriche, Punkte oder
     Bindestriche getrennt ist:
     <example>
      <title><function>split</function> Beispiel</title>
      <programlisting role="php">
<![CDATA[
$datum = "04/30/1973";  // Trennzeichen darf ein Schrgstrich, Punkt
                        // oder Bindestrich sein
list ($monat, $tag, $jahr) = split ('[/.-]', $datum);
echo "Monat: $monat; Tag: $tag; Jahr: $jahr<br>\n";
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Beachten Sie, dass <parameter>Suchmuster</parameter> Gro- und
     Kleinschreibung bercksichtigt.
    </para>
    <para>
     Beachten Sie: wenn Sie die Fhigkeiten regulrer Ausdrcke nicht
     bentigen, ist die Verwendung von <function>explode</function>
     schneller, weil diese Funktion nicht unter der Last der Engine
     fr regulre Ausdrcke steht.
    </para>
    <para>
     Wenn Sie nach einer Mglichkeit suchen, das Verhalten von Perls
     <command>$chars = split('', $str)</command> nachzuahmen, schauen
     Sie sich bitte die Beispiele fr <function>preg_split</function>
     an.
    </para>
    <para>
     Bitte beachten Sie, dass <parameter>Suchmuster</parameter> ein
     regulrer Ausdruck ist. Wenn Sie eine Zerlegung an Zeichen
     vornehmen, die in regulren Ausdrcken als besondere Zeichen
     betrachtet werden, mssen Sie diese entsprechend
     kennzeichnen. Wenn Sie der Ansicht sind,
     <function>split</function> (oder, bei diesem Thema, eine andere
     Regex-Funktion) verhalte sich seltsam, lesen Sie bitte die Datei
     <filename>regex.7</filename>, die sich im
     <filename>regex/</filename> Unterverzeichnis ihrer
     PHP-Distribution befindet. Da sie im manpage-Fomat vorliegt,
     sollten Sie einen Befehl der Art <command>man
     /usr/local/src/regex/regex.7</command> verwenden, um sie zu
     lesen.
    </para>
    <para>
     Siehe auch: <function>preg_split</function>,
     <function>spliti</function>, <function>explode</function>,
     <function>implode</function>, <function>chunk_split</function>
     und <function>wordwrap</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.spliti">
   <refnamediv>
    <refname>spliti</refname>
    <refpurpose>
     Zerlegt eine Zeichenkette anhand eines regulren Ausdrucks ohne
     Bercksichtigung von Gro-/Kleinschreibung in ein Array
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>spliti</methodname>
      <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam>
      <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>Beschrnkung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion entspricht <function>split</function> mit dem
     Unterschied, dass sie bereinstimmende Buchstaben nicht nach
     Gro- und Kleinschreibung unterscheidet.
    </para>
    <para>
     Siehe auch: <function>preg_spliti</function>,
     <function>split</function>, <function>explode</function> und
     <function>implode</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.sql-regcase">
   <refnamediv>
    <refname>sql_regcase</refname>
    <refpurpose>
     Erstellt einen regulren Ausdruck fr eine Suche nach
     bereinstimmungen ohne Bercksichtigung von Gro-/Kleinschreibung
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>sql_regcase</methodname>
      <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt einen korrekten regulren Ausdruck zurck, der mit
     <parameter>Zeichenkette</parameter> ohne Bercksichtigung von
     Gro-/Kleinschreibung bereinstimmt. Dieser Ausdruck entspricht
     <parameter>Zeichenkette</parameter>, wobei jedes Zeichen in einen
     Klammerausdruck umgewandelt wird. Die Klammer enthlt dieses
     Zeichen, wenn mglich, in gro- und kleingeschriebener Form,
     andernfalls enthlt sie das ursprngliche Zeichen zweimal.
     <example>
      <title><function>sql_regcase</function> Beispiel</title>
      <programlisting role="php">
<![CDATA[
echo sql_regcase ("Foo bar");
]]>
      </programlisting>
     </example>
     Gibt <screen>[Ff][Oo][Oo] [Bb][Aa][Rr]</screen> aus.
    </para>
    <para>
     Dies kann bei Produkten, die nur regulre Ausdrcke mit
     Bercksichtigung von Gro-/Kleinschreibung untersttzen,
     verwendet werden, um eine bereinstimmung mit Suchmustern ohne
     Bercksichtigung von Gro-/Kleinschreibung zu erreichen.
    </para>
   </refsect1>
  </refentry>


 </reference>

<!-- 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
-->