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

From: Date: Wed, 19 May 2004 19:20:19 +0000
Subject: cvs: phpdoc-de /reference/pcre/functions preg-split.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-1159@lists.php.net to get a copy of this message
samesch Wed May 19 15:20:19 2004 EDT Added files: /phpdoc-de/reference/pcre/functions preg-split.xml Log: added; initial translation http://cvs.php.net/co.php/phpdoc-de/reference/pcre/functions/preg-split.xml?r=1.1&p=1 Index: phpdoc-de/reference/pcre/functions/preg-split.xml +++ phpdoc-de/reference/pcre/functions/preg-split.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> <!-- splitted from ./en/functions/pcre.xml, last change in rev 1.2 --> <refentry id="function.preg-split"> <refnamediv> <refname>preg_split</refname> <refpurpose> Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> <methodsynopsis> <type>array</type><methodname>preg_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>Limit</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>Flags</parameter></methodparam> </methodsynopsis> <para> Gibt ein Array zurück, das aus Teilketten der an den mit <parameter>Suchmuster</parameter> übereinstimmenden Trennsymbolen zerlegten <parameter>Zeichenkette</parameter> besteht. </para> <para> Falls <parameter>Limit</parameter> angegeben wurde, werden maximal <parameter>Limit</parameter> Teilketten zurückgegeben und falls <parameter>Limit</parameter> -1 ist, bedeutet das "kein Limit", was für die Angabe von <parameter>Flags</parameter> sinnvoll ist. </para> <para> <parameter>Flags</parameter> kann jede Kombination der folgenden Flags sein (verknüpft mit dem bitweisen | Operator): <variablelist> <varlistentry> <term><constant>PREG_SPLIT_NO_EMPTY</constant></term> <listitem> <simpara> Wenn dieses Flag gesetzt ist, werden von <function>preg_split</function> nur die Teile zurückgegeben, die nicht leer sind. </simpara> </listitem> </varlistentry> <varlistentry> <term><constant>PREG_SPLIT_DELIM_CAPTURE</constant></term> <listitem> <simpara> Wenn dieses Flag gesetzt ist, werden auch die eingeklammerten Ausdrücke des Trennsymbol-Suchmusters erfasst und zurückgegeben. Dieses Flag wurde in PHP 4.0.5 hinzugefügt. </simpara> </listitem> </varlistentry> <varlistentry> <term><constant>PREG_SPLIT_OFFSET_CAPTURE</constant></term> <listitem> <para> 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 <parameter>Zeichenkette</parameter> als Element <literal>1</literal> besteht. Dieses Flag steht seit PHP 4.3.0 zur Verfügung. </para> </listitem> </varlistentry> </variablelist> </para> <para> <example> <title> <function>preg_split</function> Beispiel: Einen Suchstring in seine Bestandteile zerlegen </title> <programlisting role="php"> <![CDATA[ <?php // zerlegt die Zeichenkette an Stellen mit beliebiger Anzahl von // Kommata oder Leerzeichen, die " ", \r, \t, \n und \f umfassen $schluesselwoerter = preg_split("/[\s,]+/", "hypertext language, programming"); ?> ]]> </programlisting> </example> </para> <para> <example> <title>Eine Zeichenkette in einzelne Zeichen zerlegen</title> <programlisting role="php"> <![CDATA[ <?php $str = 'Zeichenkette'; $zeichen = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY); print_r($zeichen); ?> ]]> </programlisting> </example> </para> <para> <example> <title> Eine Zeichenkette in Übereinstimmungen mit dem Suchmuster und deren Versatz zerlegen </title> <programlisting role="php"> <![CDATA[ <?php $str = 'hypertext language programming'; $zeichen = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE); print_r($zeichen); ?> ]]> </programlisting> <para> das liefert: </para> <screen> <![CDATA[ Array ( [0] => Array ( [0] => hypertext [1] => 0 ) [1] => Array ( [0] => language [1] => 10 ) [2] => Array ( [0] => programming [1] => 19 ) ) ]]> </screen> </example> </para> <note> <para> Der Parameter <parameter>Flags</parameter> wurde in PHP 4 Beta 3 hinzugefügt. </para> </note> <para> Siehe auch <function>spliti</function>, <function>split</function>, <function>implode</function>, <function>preg_match</function>, <function>preg_match_all</function> und <function>preg_replace</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 (#1159) next »