cvs: phpdoc-de /reference/pcre/functions preg-split.xml
| From: | Martin Samesch | 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
-->