cvs: phpdoc-de /reference/strings/functions chop.xml chr.xml chunk-split.xml trim.xml ucfirst.xml ucwords.xml vfprintf.xml vprintf.xml vsprintf.xml
wordwrap.xml /reference/zlib configure.xml constants.xml ini.xml reference.xml
| From: | Carola 'Sammy' Kummert | Date: | Wed, 17 Oct 2007 00:05:47 +0000 |
| Subject: | cvs: phpdoc-de /reference/strings/functions chop.xml chr.xml chunk-split.xml trim.xml ucfirst.xml ucwords.xml vfprintf.xml vprintf.xml vsprintf.xml wordwrap.xml /reference/zlib configure.xml constants.xml ini.xml reference.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2249@lists.php.net to get a copy of this message | ||
sammywg Wed Oct 17 00:05:47 2007 UTC
Added files:
/phpdoc-de/reference/zlib constants.xml ini.xml
Modified files:
/phpdoc-de/reference/strings/functions chop.xml chr.xml
chunk-split.xml trim.xml
ucfirst.xml ucwords.xml
vfprintf.xml vprintf.xml
vsprintf.xml wordwrap.xml
/phpdoc-de/reference/zlib configure.xml reference.xml
Log:
sync to en
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/chop.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/chop.xml diff -u phpdoc-de/reference/strings/functions/chop.xml:1.5 phpdoc-de/reference/strings/functions/chop.xml:1.6 --- phpdoc-de/reference/strings/functions/chop.xml:1.5 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/strings/functions/chop.xml Wed Oct 17 00:05:47 2007 @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<refentry xml:id="function.chop" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.chop"> <refnamediv> <refname>chop</refname> <refpurpose>&Alias; <function>rtrim</function></refpurpose> @@ -14,6 +13,10 @@ &info.function.alias; <function>rtrim</function>. </simpara> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> <function>chop</function> unterscheidet sich von der Perl-Funktion @@ -21,8 +24,10 @@ </para> </note> </refsect1> + </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/chr.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/chr.xml diff -u phpdoc-de/reference/strings/functions/chr.xml:1.5 phpdoc-de/reference/strings/functions/chr.xml:1.6 --- phpdoc-de/reference/strings/functions/chr.xml:1.5 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/strings/functions/chr.xml Wed Oct 17 00:05:47 2007 @@ -1,24 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.chr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>chr</refname> - <refpurpose>Gibt ein einzelnes Zeichen zurück</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>chr</methodname> - <methodparam><type>int</type><parameter>ascii</parameter></methodparam> - </methodsynopsis> - <para> - Gibt einen Ein-Zeichen-String zurück, der dem angegebenen - <parameter>ascii</parameter>-Wert entspricht. - <example> - <title><function>chr</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.chr"> + <refnamediv> + <refname>chr</refname> + <refpurpose>Gibt ein einzelnes Zeichen zurück</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>chr</methodname> + <methodparam><type>int</type><parameter>ascii</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen Ein-Zeichen-String zurück, der dem angegebenen + <parameter>ascii</parameter>-Wert entspricht. + </para> + <para> + Die Funktion ergänzt <function>ord</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>ascii</parameter></term> + <listitem> + <para> + Der ASCII-Code. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt das angegebene Zeichen zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>chr</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $str = "Dieser String endet mit einem Escape-Zeichen: "; @@ -29,20 +61,23 @@ $str = sprintf("Dieser String endet mit einem Escape-Zeichen: %c", 27); ?> ]]> - </programlisting> - </example> - </para> - <para> - Eine ASCII-Tabelle finden Sie unter folgendem Link: - <link xlink:href="&url.asciitable;">&url.asciitable;</link>. - </para> - <para> - Diese Funktion ergänzt <function>ord</function>. Siehe auch - <function>sprintf</function> mit dem Formatierungs-String - <literal>%c</literal>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>sprintf</function> mit der Formatierungsanweisung <literal>%c</literal></member> + <member>Eine <link xlink:href="&url.asciitable;">ASCII-Tabelle</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/chunk-split.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/strings/functions/chunk-split.xml diff -u phpdoc-de/reference/strings/functions/chunk-split.xml:1.6 phpdoc-de/reference/strings/functions/chunk-split.xml:1.7 --- phpdoc-de/reference/strings/functions/chunk-split.xml:1.6 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/strings/functions/chunk-split.xml Wed Oct 17 00:05:47 2007 @@ -1,48 +1,101 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.8 Maintainer: sammywg Status: working --> - <refentry xml:id="function.chunk-split" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>chunk_split</refname> - <refpurpose>Zerlegt einen String in Teile gleicher Länge</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>chunk_split</methodname> - <methodparam><type>string</type><parameter>body</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>chunklen</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>end</parameter></methodparam> - </methodsynopsis> - <para> - Kann für die Aufteilung eines Strings in kleinere Stücke verwendet - werden. Dies ist z.B. hilfreich bei der Umwandlung von - <function>base64_encode</function>-Ausgaben, die RFC 2045 entsprechen - müssen. Die Funktion fügt die in <parameter>end</parameter> angegebene - Zeichenkette (standardmäßig "\r\n") nach jeweils <parameter>chunklen</parameter> - Zeichen (Vorgabewert 76 Zeichen) in den ursprünglichen String ein. - Zurückgegeben wird der veränderte String, die ursprüngliche Zeichenkette - bleibt unverändert. - <example> - <title><function>chunk_split</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready --> +<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.chunk-split"> + <refnamediv> + <refname>chunk_split</refname> + <refpurpose>Zerlegt einen String in Teile gleicher Länge</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>chunk_split</methodname> + <methodparam><type>string</type><parameter>body</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>chunklen</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>end</parameter></methodparam> + </methodsynopsis> + <para> + Kann für die Aufteilung eines Strings in kleinere Stücke verwendet + werden. Dies ist z.B. hilfreich bei der Umwandlung von + <function>base64_encode</function>-Ausgaben, die RFC 2045 entsprechen + müssen. Die Funktion fügt die in <parameter>end</parameter> angegebene + Zeichenkette nach jeweils <parameter>chunklen</parameter> + Zeichen in den ursprünglichen String ein. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>body</parameter></term> + <listitem> + <para> + Die zu zerlegende Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>chunklen</parameter></term> + <listitem> + <para> + Die Länge der einzelnen Teilstücke. Standardwert ist 76. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>end</parameter></term> + <listitem> + <para> + Die Zeilenend-Sequenz. Standardwert ist "\r\n". + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den zerteilten String zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>chunk_split</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php // formatiert $data unter Beachtung von RFC 2045 $neuer_string = chunk_split(base64_encode($data)); ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Siehe auch <function>str_split</function>, - <function>explode</function>, <function>split</function>, - <function>wordwrap</function> und - <link xlink:href="&url.rfc;2045">RFC 2045</link>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>str_split</function></member> + <member><function>explode</function></member> + <member><function>split</function></member> + <member><function>wordwrap</function></member> + <member><link xlink:href="&url.rfc;2045">RFC 2045</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/trim.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/trim.xml diff -u phpdoc-de/reference/strings/functions/trim.xml:1.5 phpdoc-de/reference/strings/functions/trim.xml:1.6 --- phpdoc-de/reference/strings/functions/trim.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/trim.xml Wed Oct 17 00:05:47 2007 @@ -1,24 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.10 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<refentry xml:id="function.trim" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.trim"> <refnamediv> - <refname>trim</refname> - <refpurpose> - Entfernt Whitespaces (oder andere Zeichen) am Anfang und Ende eines Strings - </refpurpose> + <refname>trim</refname> + <refpurpose>Entfernt Whitespaces (oder andere Zeichen) am Anfang und Ende eines Strings</refpurpose> </refnamediv> - + <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>trim</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charlist</parameter></methodparam> + <type>string</type><methodname>trim</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charlist</parameter></methodparam> </methodsynopsis> <para> - Die Funktion entfernt Whitespaces an Anfang und Ende von + Die Funktion entfernt Whitespaces an Anfang und Ende von <parameter>str</parameter> und gibt den String dann zurück. Ohne Verwendung des zweiten Parameters entfernt <function>trim</function> folgende Zeichen: @@ -26,37 +23,37 @@ <itemizedlist> <listitem> <simpara> - " " (<acronym>ASCII</acronym> <literal>32</literal> + " " (<acronym>ASCII</acronym> <literal>32</literal> (<literal>0x20</literal>)), ein normales Leerzeichen. </simpara> </listitem> <listitem> <simpara> - "\t" (<acronym>ASCII</acronym> <literal>9</literal> + "\t" (<acronym>ASCII</acronym> <literal>9</literal> (<literal>0x09</literal>)), ein Tabulatorzeichen. </simpara> </listitem> <listitem> <simpara> - "\n" (<acronym>ASCII</acronym> <literal>10</literal> + "\n" (<acronym>ASCII</acronym> <literal>10</literal> (<literal>0x0A</literal>)), einen Zeilenvorschub (Line Feed). </simpara> </listitem> <listitem> <simpara> - "\r" (<acronym>ASCII</acronym> <literal>13</literal> + "\r" (<acronym>ASCII</acronym> <literal>13</literal> (<literal>0x0D</literal>)), ein Wagenrücklaufzeichen (Carriage Return). </simpara> </listitem> <listitem> <simpara> - "\0" (<acronym>ASCII</acronym> <literal>0</literal> + "\0" (<acronym>ASCII</acronym> <literal>0</literal> (<literal>0x00</literal>)), das <literal>NUL</literal>-Byte. </simpara> </listitem> <listitem> <simpara> <!-- not \v, since not supported by PHP --> - "\x0B" (<acronym>ASCII</acronym> <literal>11</literal> + "\x0B" (<acronym>ASCII</acronym> <literal>11</literal> (<literal>0x0B</literal>)), ein vertikaler Tabulator. </simpara> </listitem> @@ -134,28 +131,54 @@ <?php $text = "\t\tDieser Text besteht aus mehreren Wörtern :) ... "; +$binary = "\x09Beispeilhafter String\x0A"; +$hello = "Hallo Welt"; +var_dump($text, $binary, $hello); + +print "\n"; + +$trimmed = trim($text); +var_dump($trimmed); -echo trim($text); // "Dieser Text besteht aus mehreren Wörtern :) ..." -echo trim($text, " \t."); // "Dieser Text besteht aus mehreren Wörtern :)" +$trimmed = trim($text, " \t."); +var_dump($trimmed); + +$trimmed = trim($hello, "Htla"); +var_dump($trimmed); // Trimmen der ASCII Steuerzeichen an Anfang und Ende von $binary // (inklusive der Zeichen von ASCII 0 bis 31) $clean = trim($binary, "\x00..\x1F"); +var_dump($clean); ?> ]]> </programlisting> + &example.outputs; + <screen> +<![CDATA[ +string(51) " Dieser Text besteht aus mehreren Wörtern :) ... " +string(23) " Beispeilhafter String +" +string(10) "Hallo Welt" + +string(47) "Dieser Text besteht aus mehreren Wörtern :) ..." +string(43) "Dieser Text besteht aus mehreren Wörtern :)" +string(4) "o We" +string(21) "Beispeilhafter String" +]]> + </screen> </example> </para> <para> <example> - <title>Trimmen von Array Werten mittels <function>trim</function></title> + <title>Trimmen von Array-Werten mittels <function>trim</function></title> <programlisting role="php"> <![CDATA[ <?php -function trim_value(&$value) -{ - $value = trim($value); +function trim_value(&$value) +{ + $value = trim($value); } $fruechte = array('Apfel','Banane ', ' Preiselbeere '); http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/ucfirst.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/strings/functions/ucfirst.xml diff -u phpdoc-de/reference/strings/functions/ucfirst.xml:1.7 phpdoc-de/reference/strings/functions/ucfirst.xml:1.8 --- phpdoc-de/reference/strings/functions/ucfirst.xml:1.7 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/ucfirst.xml Wed Oct 17 00:05:47 2007 @@ -1,33 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.3 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.ucfirst" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>ucfirst</refname> - <refpurpose> - Verwandelt das erste Zeichen eines Strings in einen Großbuchstaben - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>ucfirst</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Wandelt das erste Zeichen von <parameter>str</parameter> in einen - Großbuchstaben um, wenn es ein Zeichen des Alphabets ist, und gibt den - veränderten String zurück. - </para> - <para> - Beachten Sie, dass die Zeichen des Alphabets abhängig vom - Wert des gesetzten locale erkannt werden. Ist der Voreinstellung "C" - werden Sonderzeichen wie die deutschen Umlaute (ä etc.) nicht erkannt - und daher nicht umgewandelt. - <example> - <title><function>ucfirst</function>-Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ucfirst"> + <refnamediv> + <refname>ucfirst</refname> + <refpurpose>Verwandelt das erste Zeichen eines Strings in einen Großbuchstaben</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>ucfirst</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Wandelt das erste Zeichen von <parameter>str</parameter> in einen + Großbuchstaben um, wenn es ein Zeichen des Alphabets ist, und gibt den + veränderten String zurück. + </para> + <para> + Beachten Sie, dass die Zeichen des Alphabets abhängig vom + Wert des gesetzten locale erkannt werden. Ist der Voreinstellung "C" + werden Sonderzeichen wie die deutschen Umlaute (ä etc.) nicht erkannt + und daher nicht umgewandelt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den umgewandelten String zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>ucfirst</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $foo = 'hallo welt!'; @@ -38,15 +65,24 @@ $bar = ucfirst(strtolower($bar)); // Hallo welt! ?> ]]> - </programlisting> - </example> - </para> - <para> - Siehe auch <function>strtolower</function>, <function>strtoupper</function> - und <function>ucwords</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strtolower</function></member> + <member><function>strtoupper</function></member> + <member><function>ucwords</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/ucwords.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/ucwords.xml diff -u phpdoc-de/reference/strings/functions/ucwords.xml:1.5 phpdoc-de/reference/strings/functions/ucwords.xml:1.6 --- phpdoc-de/reference/strings/functions/ucwords.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/ucwords.xml Wed Oct 17 00:05:47 2007 @@ -1,35 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.23 --> - <refentry xml:id="function.ucwords" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>ucwords</refname> - <refpurpose> - Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings - in einen Großbuchstaben - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>ucwords</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Gibt einen String zurück, in dem das erste Zeichen eines jeden Wortes - innerhalb von <parameter>str</parameter> in einen Großbuchstaben - umgewandelt wurde, sofern es sich dabei um Buchstaben handelt. - </para> - <simpara> - Als Wort wird hierbei eine Zeichenkette verstanden, die einem - Whitespace (Leerzeichen, Seitenvorschub, Zeilenvorschub, Wagenrücklauf - sowie horizontalem und vertikalem Tabulatorzeichen) folgt. - </simpara> - <para> - <example> - <title><function>ucwords</function>-Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ucwords"> + <refnamediv> + <refname>ucwords</refname> + <refpurpose>Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings + in einen Großbuchstaben</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>ucwords</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen String zurück, in dem das erste Zeichen eines jeden Wortes + innerhalb von <parameter>str</parameter> in einen Großbuchstaben + umgewandelt wurde, sofern es sich dabei um Buchstaben handelt. + </para> + <para> + Als Wort wird hierbei eine Zeichenkette verstanden, die einem + Whitespace (Leerzeichen, Seitenvorschub, Zeilenvorschub, Wagenrücklauf + sowie horizontalem und vertikalem Tabulatorzeichen) folgt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die modifizierte Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>ucwords</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $foo = 'hallo welt!'; @@ -40,18 +65,29 @@ $bar = ucwords(strtolower($bar)); // Hallo Welt! ?> ]]> - </programlisting> - </example> - </para> - - ¬e.bin-safe; - - <para> - Siehe auch <function>strtoupper</function>, - <function>strtolower</function> und <function>ucfirst</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strtoupper</function></member> + <member><function>strtolower</function></member> + <member><function>ucfirst</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/vfprintf.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/strings/functions/vfprintf.xml diff -u phpdoc-de/reference/strings/functions/vfprintf.xml:1.2 phpdoc-de/reference/strings/functions/vfprintf.xml:1.3 --- phpdoc-de/reference/strings/functions/vfprintf.xml:1.2 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/vfprintf.xml Wed Oct 17 00:05:47 2007 @@ -1,46 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.2 Maintainer: sammywg Status: working --> - <refentry xml:id="function.vfprintf" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>vfprintf</refname> - <refpurpose>Schreibt einen formatierten String in einen Stream</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>vfprintf</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam><type>array</type><parameter>args</parameter></methodparam> - </methodsynopsis> - <simpara> - Schreibt einen der <parameter>Format</parameter>anweisung entsprechenden - String in den im <parameter>handle</parameter> definierten Stream. - Die möglichen <parameter>Format</parameter>-Anweisungen sind in der Funktion - <function>sprintf</function> dokumentiert. - </simpara> - <simpara> - Verhält sich wie <function>fprintf</function>, akzeptiert jedoch ein Array - anstelle einer Gruppe von Werten als Parameter. - </simpara> - <simpara> - Gibt die Länge des formatierten Strings zurück. - </simpara> - <simpara> - Siehe auch <function>printf</function>, - <function>sprintf</function>, - <function>sscanf</function>, <function>fscanf</function>, - <function>vsprintf</function>, und - <function>number_format</function>. - </simpara> - </refsect1> - <refsect1> - <title>Beispiel:</title> - <para> - <example> - <title><function>vfprintf</function>: Integer-Werte mit führenden Nullen</title> - <programlisting role="php"> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.5 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vfprintf"> + <refnamediv> + <refname>vfprintf</refname> + <refpurpose>Schreibt einen formatierten String in einen Stream</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>vfprintf</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam><type>array</type><parameter>args</parameter></methodparam> + </methodsynopsis> + <para> + Schreibt einen der <parameter>Format</parameter>anweisung entsprechenden + String in den im <parameter>handle</parameter> definierten Stream. + </para> + <para> + Verhält sich wie <function>fprintf</function>, akzeptiert jedoch ein Array + anstelle einer Gruppe von Werten als Parameter. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + Die möglichen <parameter>Format</parameter>-Anweisungen sind in der + Funktion <function>sprintf</function> dokumentiert. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>args</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Länge des Ausgabestrings zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>vfprintf</function>: Integer-Werte mit führenden Nullen</title> + <programlisting role="php"> <![CDATA[ <?php if (!($fp = fopen('date.txt', 'w'))) @@ -50,11 +78,27 @@ // schreibt das ISO-formatierte Datum in die Daten date.txt ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>printf</function></member> + <member><function>sprintf</function></member> + <member><function>sscanf</function></member> + <member><function>fscanf</function></member> + <member><function>vsprintf</function></member> + <member><function>number_format</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/vprintf.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/strings/functions/vprintf.xml diff -u phpdoc-de/reference/strings/functions/vprintf.xml:1.3 phpdoc-de/reference/strings/functions/vprintf.xml:1.4 --- phpdoc-de/reference/strings/functions/vprintf.xml:1.3 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/vprintf.xml Wed Oct 17 00:05:47 2007 @@ -1,37 +1,72 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/strings.xml, last change in rev 1.124 --> -<!-- EN-Revision: 1.4 Maintainer: sammywg Status: working --> - <refentry xml:id="function.vprintf" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>vprintf</refname> - <refpurpose>Gibt einen formatierten String zurück</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>vprintf</methodname> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam><type>array</type><parameter>args</parameter></methodparam> - </methodsynopsis> - <simpara> - Zeigt die Werte eines Arrays als formatierten String entsprechend der - <parameter>Format</parameter>anweisungen (siehe Beschreibung der - Formatierungsmöglichkeiten der Funktion <function>sprintf</function>). - </simpara> - <simpara> - Arbeitet wie <function>printf</function>, akzeptiert jedoch ein Array - anstelle mehrerer Werte als Argument. - </simpara> - <simpara> - Gibt die Länge des Ausgabestrings zurück. - </simpara> - <simpara> - Siehe auch <function>printf</function>, <function>sprintf</function>, - <function>vsprintf</function> - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vprintf"> + <refnamediv> + <refname>vprintf</refname> + <refpurpose>Gibt einen formatierten String zurück</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>vprintf</methodname> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam><type>array</type><parameter>args</parameter></methodparam> + </methodsynopsis> + <para> + Zeigt die Werte eines Arrays als formatierten String entsprechend der + <parameter>Format</parameter>anweisungen (siehe Beschreibung der + Formatierungsmöglichkeiten der Funktion <function>sprintf</function>) an. + </para> + <para> + Arbeitet wie <function>printf</function>, akzeptiert jedoch ein Array + anstelle mehrerer Werte als Argument. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>args</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Länge des Ausgabestrings zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>printf</function></member> + <member><function>sprintf</function></member> + <member><function>vsprintf</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/vsprintf.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/strings/functions/vsprintf.xml diff -u phpdoc-de/reference/strings/functions/vsprintf.xml:1.2 phpdoc-de/reference/strings/functions/vsprintf.xml:1.3 --- phpdoc-de/reference/strings/functions/vsprintf.xml:1.2 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/vsprintf.xml Wed Oct 17 00:05:47 2007 @@ -1,34 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./en/functions/strings.xml, last change in rev 1.124 --> -<!-- EN-Revision: 1.4 Maintainer: sammywg Status: working --> - <refentry xml:id="function.vsprintf" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>vsprintf</refname> - <refpurpose>Gibt einen formatierten String zurück</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>vsprintf</methodname> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam><type>array</type><parameter>args</parameter></methodparam> - </methodsynopsis> - <simpara> - Gibt Array-Werte als formatierten String entsprechend der - <parameter>Format</parameter>anweisung (siehe Beschreibung der - Formatierungsmöglichkeiten der Funktion <function>sprintf</function>) - zurück. - </simpara> - <simpara> - Verhält sich wie <function>sprintf</function>, akzeptiert jedoch ein - Array anstelle mehrerer Werte als Parameter. - </simpara> - <simpara> - Siehe auch <function>sprintf</function> und <function>vprintf</function> - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vsprintf"> + <refnamediv> + <refname>vsprintf</refname> + <refpurpose>Gibt einen formatierten String zurück</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>vsprintf</methodname> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam><type>array</type><parameter>args</parameter></methodparam> + </methodsynopsis> + <para> + Verhält sich wie <function>sprintf</function>, akzeptiert jedoch ein + Array anstelle mehrerer Werte als Parameter. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>args</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt Array-Werte als formatierten String entsprechend der + <parameter>Format</parameter>anweisung (siehe Beschreibung der + Formatierungsmöglichkeiten der Funktion <function>sprintf</function>) + zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>sprintf</function></member> + <member><function>vprintf</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/wordwrap.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/wordwrap.xml diff -u phpdoc-de/reference/strings/functions/wordwrap.xml:1.5 phpdoc-de/reference/strings/functions/wordwrap.xml:1.6 --- phpdoc-de/reference/strings/functions/wordwrap.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/wordwrap.xml Wed Oct 17 00:05:47 2007 @@ -1,97 +1,161 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.13 Maintainer: sammywg Status: working --> - <refentry xml:id="function.wordwrap" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>wordwrap</refname> - <refpurpose> - Bricht einen String nach einer bestimmten Anzahl Zeichen mittels - des angegebenen Trennzeichens um. - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>string</type><methodname>wordwrap</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>width</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>break</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>cut</parameter></methodparam> - </methodsynopsis> - <para> - Bricht den String <parameter>str</parameter> an der mittels - des optionalen Parameters <parameter>width</parameter> angegebenen - Position um. Als Zeilenumbruch wird der (optionale) Parameter - <parameter>break</parameter> verwendet. - </para> - <para> - Die Funktion <function>wordwrap</function> bricht einen String - automatisch nach dem 75sten Zeichen unter Verwendung des - Steuerzeichens '<literal>\n</literal>' (neue Zeile) um, sofern die - Parameter <parameter>width</parameter> und/oder - <parameter>break</parameter> nicht angegeben sind. - </para> - <para> - Ist für <parameter>cut</parameter> der Wert 1 angegeben, wird der - String immer an der vorgegebenen Position umgebrochen. Ist also ein - Wort länger als die vorgegeben, wird der Zeilumbruch innerhalb des Wortes - eingefügt (siehe zweites Beispiel). - <note> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.17 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.wordwrap"> + <refnamediv> + <refname>wordwrap</refname> + <refpurpose>Bricht einen String nach einer bestimmten Anzahl Zeichen um</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>wordwrap</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>width</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>break</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>cut</parameter></methodparam> + </methodsynopsis> + <para> + Bricht einen String nach einer bestimmten Anzahl Zeichen mittels eines + angegebenen Trennzeichens um. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>width</parameter></term> + <listitem> + <para> + Die Spaltenbreite des Umbruchs. Standardwert sind 75 Zeichen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>break</parameter></term> + <listitem> + <para> + Der optionale Parameter <parameter>break</parameter> wird als Zeichen(kette) + für den Zeilenumbruch verwendet. Standardwert ist '<literal>\n</literal>'. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cut</parameter></term> + <listitem> <para> - Der optionale Parameter <parameter>cut</parameter> wurde in PHP 4.0.3 - eingeführt. + Wenn der Parameter <parameter>cut</parameter> auf &true; gesetzt ist, + wird die Zeichenkette immer nach der angegebenen Länge umgebrochen. + Wenn sie also ein Wort haben, das länger als die angegebene + Maximallänge ist, wird der Umbruch im Wort selbst durchgeführt (siehe + zweites Beispiel). </para> - </note> - </para> - <example> - <title><function>wordwrap</function>-Beispiel:</title> - <programlisting role="php"> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die übergebene Zeichenkette zurück, die an der angegebenen Trennstelle + umgebrochen wurde. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.0.3</entry> + <entry> + Der optionale Parameter <parameter>cut</parameter> wurde hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>wordwrap</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ $text = "Der schnelle braune Fuchs sprang über den faulen Hund."; $neuertext = wordwrap( $text, 20, "<br />\n" ); echo $neuertext; ]]> - </programlisting> - <para> - Dieses Beispiel gibt aus: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ -Der schnelle braune<br /> -Fuchs sprang über<br /> +Der schnelle braune<br /> +Fuchs sprang über<br /> den faulen Hund. ]]> - </screen> - </example> - <example> - <title><function>wordwrap</function>-Beispiel:</title> - <programlisting role="php"> + </screen> + </example> + <example> + <title><function>wordwrap</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ $text = "Ein sehr langes Wooooooooooort."; -$neuertext = wordwrap($text, 8, "\n", 1); +$neuertext = wordwrap($text, 8, "\n", true); echo "$neuertext\n"; ]]> - </programlisting> - <para> - Dieses Beispiel gibt aus: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Ein sehr langes Wooooooo oooort. ]]> - </screen> - </example> - <para> - Siehe auch <function>nl2br</function> und - <function>chunk_split</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>nl2br</function></member> + <member><function>chunk_split</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/zlib/configure.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/zlib/configure.xml diff -u phpdoc-de/reference/zlib/configure.xml:1.3 phpdoc-de/reference/zlib/configure.xml:1.4 --- phpdoc-de/reference/zlib/configure.xml:1.3 Sat Jun 23 13:21:53 2007 +++ phpdoc-de/reference/zlib/configure.xml Wed Oct 17 00:05:47 2007 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: nobody Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: sammywg Status: ready --> <section xml:id="zlib.installation" xmlns="http://docbook.org/ns/docbook"> &reftitle.install; <para> - Die Unterstützung für Zlib ist in PHP nicht standardmäßig aktiviert. Es ist + Die Unterstützung für zlib ist in PHP nicht standardmäßig aktiviert. Es ist erforderlich, die Option <option role="configure">--with-zlib[=DIR]</option> beim Kompilieren von PHP anzugeben. </para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/zlib/reference.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/zlib/reference.xml diff -u phpdoc-de/reference/zlib/reference.xml:1.5 phpdoc-de/reference/zlib/reference.xml:1.6 --- phpdoc-de/reference/zlib/reference.xml:1.5 Sat Jun 23 13:21:53 2007 +++ phpdoc-de/reference/zlib/reference.xml Wed Oct 17 00:05:47 2007 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.16 Maintainer: nobody Status: ready --> -<!-- CREDITS: nohn --> -<!-- Purpose: compression --> -<!-- Membership: bundled --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.18 Maintainer: sammywg Status: ready --> <reference xml:id="ref.zlib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Zlib Komprimierungsfunktionen</title> @@ -13,8 +10,8 @@ <section xml:id="zlib.intro"> &reftitle.intro; <para> - Dieses Modul gibt Ihnen die Möglichkeit, transparent gzip (.gz) - - komprimierte Dateien zu lesen und zu schreiben. Hierfür bietet diese + Dieses Modul gibt Ihnen die Möglichkeit, transparent gzip-komprimierte + Dateien (*.gz) zu lesen und zu schreiben. Hierfür bietet die Erweiterung die Versionen der meisten <link linkend="ref.filesystem">Dateisystem</link>-Funktionen, die mit gzip-komprimierten (und unkomprimierten) Dateien, jedoch nicht mit @@ -23,7 +20,7 @@ <note> <para> Mit Version 4.0.4 wurde ein fopen-wrapper für .gz-Dateien eingeführt, - so dass Sie die spezielle <filename>zlib:</filename>-URL verwenden + so dass Sie den speziellen <filename>zlib:</filename>-URL verwenden können, um auf komprimierte Dateien transparent über die f*()-Dateifunktionen zuzugreifen. Beim Aufruf von <function>fopen</function> müssen Sie dazu lediglich vor dem Dateinamen @@ -38,7 +35,7 @@ <filename>compress.zlib://</filename> geändert, um Konflikte mit Dateinamen zu vermeiden die ':' Zeichen enthalten. Die <literal>fopencookie()</literal> Funktion wird nicht mehr benötigt. Mehr - Information hierzu finden Sie im Abschnitt über + Information hierzu finden Sie im Abschnitt über <xref linkend="wrappers.compression" />. </para> <para> @@ -62,7 +59,10 @@ <section xml:id="zlib.resources"> &reftitle.resources; - &no.resource; + <para> + Die Extension definiert eine Filepointer-Ressource, die von + <function>gzopen</function> zurückgegeben wird. + </para> </section> &reference.zlib.constants; @@ -70,8 +70,8 @@ <section xml:id="zlib.examples"> &reftitle.examples; <para> - Dieses Beispiel öffnet eine temporäre Datei und schreibt einen Test - String in die Datei, dann wird der Inhalt dieser Datei zweimal ausgegeben. + Dieses Beispiel öffnet eine temporäre Datei und schreibt einen Teststring + in die Datei, dann wird der Inhalt dieser Datei zweimal ausgegeben. </para> <example> <title>Ein kleines Beispiel zu Zlib</title> @@ -95,7 +95,7 @@ // Datei zum Lesen öffnen $zp = gzopen($filename, "r"); -// 3 Zeichen ausgeben +// 3 Zeichen einlesen und ausgeben echo gzread($zp, 3); // Inhalt der Datei ausgeben und die Datei schließen http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/zlib/constants.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/zlib/constants.xml +++ phpdoc-de/reference/zlib/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: sammywg Status: ready --> <section xml:id="zlib.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>FORCE_GZIP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FORCE_DEFLATE</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> </section> <!-- 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: --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/zlib/ini.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/zlib/ini.xml +++ phpdoc-de/reference/zlib/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready --> <section xml:id="zlib.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; <para> Die zlib-Erweiterung gibt Ihnen die Möglichkeit, Ihre Seiten on-the-fly transparent zu komprimieren, wenn der Browser dies unterstützt. Dafür gibt es drei Optionen in der <link linkend="configuration.file">Konfigurationsdatei</link> &php.ini;. <table> <title>Zlib-Konfigurationsoptionen</title> <tgroup cols="4"> <thead> <row> <entry>Name</entry> <entry>Standardwert</entry> <entry>Veränderbar</entry> <entry>Changelog</entry> </row> </thead> <tbody> <row> <entry>zlib.output_compression</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> <entry>Verfügbar seit PHP 4.0.5.</entry> </row> <row> <entry>zlib.output_compression_level</entry> <entry>"-1"</entry> <entry>PHP_INI_ALL</entry> <entry>Verfügbar seit PHP 4.3.0.</entry> </row> <row> <entry>zlib.output_handler</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> <entry>Verfügbar seit PHP 4.3.0.</entry> </row> </tbody> </tgroup> </table> &ini.php.constants; </para> &ini.descriptions.title; <para> <variablelist> <varlistentry xml:id="ini.zlib.output-compression"> <term> <parameter>zlib.output_compression</parameter> <type>boolean</type>/<type>integer</type> </term> <listitem> <para> Wenn diese Option in der &php.ini; oder der Apachekonfiguration auf "On" gesetzt ist, werden die Seiten komprimiert, wenn der Browser einen "Accept-Encoding: gzip"- oder einen "deflate"-Header sendet. Zu den normalerweise vom Server gesendeten Headern werden nun "Content-Encoding: gzip" (respektive "deflate") und "Vary: Accept-Encoding" hinzugefügt. Zur Laufzeit kann die Option nur gesetzt werden, bevor irgendeine Ausgabe gesendet wurde. </para> <para> Diese Option akzeptiert auch Integerwerte anstelle des boolschen On/Off, wenn Sie diese verwenden, können Sie die Ausgabepuffergröße festlegen (der Standardwert ist 4KB). </para> <note> <para> <link linkend="ini.output-handler">output_handler</link> muss leer sein, wenn diese Option den Wert "On" hat! Verwenden Sie statt dessen zlib.output_handler. </para> </note> </listitem> </varlistentry> <varlistentry xml:id="ini.zlib.output-compression-level"> <term> <parameter>zlib.output_compression_level</parameter> <type>integer</type> </term> <listitem> <para> Der Kompressionsgrad für die transparente Ausgabekomprimierung. </para> </listitem> </varlistentry> <varlistentry xml:id="ini.zlib.output-handler"> <term> <parameter>zlib.output_handler</parameter> <type>string</type> </term> <listitem> <para> Sie können keine zusätzlichen Outputhandler angeben, wenn Sie zlib.output_compression aktiviert haben. Diese Einstellung tut das Gleiche wie <link linkend="ini.output-handler">output_handler</link>, allerdings in einer anderen Reihenfolge. </para> </listitem> </varlistentry> </variablelist> </para> </section> <!-- 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/viewvc.cgi/phpdoc-de/reference/strings/functions/chop.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/chop.xml diff -u phpdoc-de/reference/strings/functions/chop.xml:1.5 phpdoc-de/reference/strings/functions/chop.xml:1.6 --- phpdoc-de/reference/strings/functions/chop.xml:1.5 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/strings/functions/chop.xml Wed Oct 17 00:05:47 2007 @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<refentry xml:id="function.chop" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.chop"> <refnamediv> <refname>chop</refname> <refpurpose>&Alias; <function>rtrim</function></refpurpose> @@ -14,6 +13,10 @@ &info.function.alias; <function>rtrim</function>. </simpara> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> <function>chop</function> unterscheidet sich von der Perl-Funktion @@ -21,8 +24,10 @@ </para> </note> </refsect1> + </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/chr.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/chr.xml diff -u phpdoc-de/reference/strings/functions/chr.xml:1.5 phpdoc-de/reference/strings/functions/chr.xml:1.6 --- phpdoc-de/reference/strings/functions/chr.xml:1.5 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/strings/functions/chr.xml Wed Oct 17 00:05:47 2007 @@ -1,24 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.chr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>chr</refname> - <refpurpose>Gibt ein einzelnes Zeichen zurück</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>chr</methodname> - <methodparam><type>int</type><parameter>ascii</parameter></methodparam> - </methodsynopsis> - <para> - Gibt einen Ein-Zeichen-String zurück, der dem angegebenen - <parameter>ascii</parameter>-Wert entspricht. - <example> - <title><function>chr</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.chr"> + <refnamediv> + <refname>chr</refname> + <refpurpose>Gibt ein einzelnes Zeichen zurück</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>chr</methodname> + <methodparam><type>int</type><parameter>ascii</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen Ein-Zeichen-String zurück, der dem angegebenen + <parameter>ascii</parameter>-Wert entspricht. + </para> + <para> + Die Funktion ergänzt <function>ord</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>ascii</parameter></term> + <listitem> + <para> + Der ASCII-Code. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt das angegebene Zeichen zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>chr</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $str = "Dieser String endet mit einem Escape-Zeichen: "; @@ -29,20 +61,23 @@ $str = sprintf("Dieser String endet mit einem Escape-Zeichen: %c", 27); ?> ]]> - </programlisting> - </example> - </para> - <para> - Eine ASCII-Tabelle finden Sie unter folgendem Link: - <link xlink:href="&url.asciitable;">&url.asciitable;</link>. - </para> - <para> - Diese Funktion ergänzt <function>ord</function>. Siehe auch - <function>sprintf</function> mit dem Formatierungs-String - <literal>%c</literal>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>sprintf</function> mit der Formatierungsanweisung <literal>%c</literal></member> + <member>Eine <link xlink:href="&url.asciitable;">ASCII-Tabelle</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/chunk-split.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/strings/functions/chunk-split.xml diff -u phpdoc-de/reference/strings/functions/chunk-split.xml:1.6 phpdoc-de/reference/strings/functions/chunk-split.xml:1.7 --- phpdoc-de/reference/strings/functions/chunk-split.xml:1.6 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/strings/functions/chunk-split.xml Wed Oct 17 00:05:47 2007 @@ -1,48 +1,101 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.8 Maintainer: sammywg Status: working --> - <refentry xml:id="function.chunk-split" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>chunk_split</refname> - <refpurpose>Zerlegt einen String in Teile gleicher Länge</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>chunk_split</methodname> - <methodparam><type>string</type><parameter>body</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>chunklen</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>end</parameter></methodparam> - </methodsynopsis> - <para> - Kann für die Aufteilung eines Strings in kleinere Stücke verwendet - werden. Dies ist z.B. hilfreich bei der Umwandlung von - <function>base64_encode</function>-Ausgaben, die RFC 2045 entsprechen - müssen. Die Funktion fügt die in <parameter>end</parameter> angegebene - Zeichenkette (standardmäßig "\r\n") nach jeweils <parameter>chunklen</parameter> - Zeichen (Vorgabewert 76 Zeichen) in den ursprünglichen String ein. - Zurückgegeben wird der veränderte String, die ursprüngliche Zeichenkette - bleibt unverändert. - <example> - <title><function>chunk_split</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready --> +<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.chunk-split"> + <refnamediv> + <refname>chunk_split</refname> + <refpurpose>Zerlegt einen String in Teile gleicher Länge</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>chunk_split</methodname> + <methodparam><type>string</type><parameter>body</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>chunklen</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>end</parameter></methodparam> + </methodsynopsis> + <para> + Kann für die Aufteilung eines Strings in kleinere Stücke verwendet + werden. Dies ist z.B. hilfreich bei der Umwandlung von + <function>base64_encode</function>-Ausgaben, die RFC 2045 entsprechen + müssen. Die Funktion fügt die in <parameter>end</parameter> angegebene + Zeichenkette nach jeweils <parameter>chunklen</parameter> + Zeichen in den ursprünglichen String ein. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>body</parameter></term> + <listitem> + <para> + Die zu zerlegende Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>chunklen</parameter></term> + <listitem> + <para> + Die Länge der einzelnen Teilstücke. Standardwert ist 76. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>end</parameter></term> + <listitem> + <para> + Die Zeilenend-Sequenz. Standardwert ist "\r\n". + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den zerteilten String zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>chunk_split</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php // formatiert $data unter Beachtung von RFC 2045 $neuer_string = chunk_split(base64_encode($data)); ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Siehe auch <function>str_split</function>, - <function>explode</function>, <function>split</function>, - <function>wordwrap</function> und - <link xlink:href="&url.rfc;2045">RFC 2045</link>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>str_split</function></member> + <member><function>explode</function></member> + <member><function>split</function></member> + <member><function>wordwrap</function></member> + <member><link xlink:href="&url.rfc;2045">RFC 2045</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/trim.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/trim.xml diff -u phpdoc-de/reference/strings/functions/trim.xml:1.5 phpdoc-de/reference/strings/functions/trim.xml:1.6 --- phpdoc-de/reference/strings/functions/trim.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/trim.xml Wed Oct 17 00:05:47 2007 @@ -1,24 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.10 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<refentry xml:id="function.trim" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.trim"> <refnamediv> - <refname>trim</refname> - <refpurpose> - Entfernt Whitespaces (oder andere Zeichen) am Anfang und Ende eines Strings - </refpurpose> + <refname>trim</refname> + <refpurpose>Entfernt Whitespaces (oder andere Zeichen) am Anfang und Ende eines Strings</refpurpose> </refnamediv> - + <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>trim</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charlist</parameter></methodparam> + <type>string</type><methodname>trim</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charlist</parameter></methodparam> </methodsynopsis> <para> - Die Funktion entfernt Whitespaces an Anfang und Ende von + Die Funktion entfernt Whitespaces an Anfang und Ende von <parameter>str</parameter> und gibt den String dann zurück. Ohne Verwendung des zweiten Parameters entfernt <function>trim</function> folgende Zeichen: @@ -26,37 +23,37 @@ <itemizedlist> <listitem> <simpara> - " " (<acronym>ASCII</acronym> <literal>32</literal> + " " (<acronym>ASCII</acronym> <literal>32</literal> (<literal>0x20</literal>)), ein normales Leerzeichen. </simpara> </listitem> <listitem> <simpara> - "\t" (<acronym>ASCII</acronym> <literal>9</literal> + "\t" (<acronym>ASCII</acronym> <literal>9</literal> (<literal>0x09</literal>)), ein Tabulatorzeichen. </simpara> </listitem> <listitem> <simpara> - "\n" (<acronym>ASCII</acronym> <literal>10</literal> + "\n" (<acronym>ASCII</acronym> <literal>10</literal> (<literal>0x0A</literal>)), einen Zeilenvorschub (Line Feed). </simpara> </listitem> <listitem> <simpara> - "\r" (<acronym>ASCII</acronym> <literal>13</literal> + "\r" (<acronym>ASCII</acronym> <literal>13</literal> (<literal>0x0D</literal>)), ein Wagenrücklaufzeichen (Carriage Return). </simpara> </listitem> <listitem> <simpara> - "\0" (<acronym>ASCII</acronym> <literal>0</literal> + "\0" (<acronym>ASCII</acronym> <literal>0</literal> (<literal>0x00</literal>)), das <literal>NUL</literal>-Byte. </simpara> </listitem> <listitem> <simpara> <!-- not \v, since not supported by PHP --> - "\x0B" (<acronym>ASCII</acronym> <literal>11</literal> + "\x0B" (<acronym>ASCII</acronym> <literal>11</literal> (<literal>0x0B</literal>)), ein vertikaler Tabulator. </simpara> </listitem> @@ -134,28 +131,54 @@ <?php $text = "\t\tDieser Text besteht aus mehreren Wörtern :) ... "; +$binary = "\x09Beispeilhafter String\x0A"; +$hello = "Hallo Welt"; +var_dump($text, $binary, $hello); + +print "\n"; + +$trimmed = trim($text); +var_dump($trimmed); -echo trim($text); // "Dieser Text besteht aus mehreren Wörtern :) ..." -echo trim($text, " \t."); // "Dieser Text besteht aus mehreren Wörtern :)" +$trimmed = trim($text, " \t."); +var_dump($trimmed); + +$trimmed = trim($hello, "Htla"); +var_dump($trimmed); // Trimmen der ASCII Steuerzeichen an Anfang und Ende von $binary // (inklusive der Zeichen von ASCII 0 bis 31) $clean = trim($binary, "\x00..\x1F"); +var_dump($clean); ?> ]]> </programlisting> + &example.outputs; + <screen> +<![CDATA[ +string(51) " Dieser Text besteht aus mehreren Wörtern :) ... " +string(23) " Beispeilhafter String +" +string(10) "Hallo Welt" + +string(47) "Dieser Text besteht aus mehreren Wörtern :) ..." +string(43) "Dieser Text besteht aus mehreren Wörtern :)" +string(4) "o We" +string(21) "Beispeilhafter String" +]]> + </screen> </example> </para> <para> <example> - <title>Trimmen von Array Werten mittels <function>trim</function></title> + <title>Trimmen von Array-Werten mittels <function>trim</function></title> <programlisting role="php"> <![CDATA[ <?php -function trim_value(&$value) -{ - $value = trim($value); +function trim_value(&$value) +{ + $value = trim($value); } $fruechte = array('Apfel','Banane ', ' Preiselbeere '); http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/ucfirst.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/strings/functions/ucfirst.xml diff -u phpdoc-de/reference/strings/functions/ucfirst.xml:1.7 phpdoc-de/reference/strings/functions/ucfirst.xml:1.8 --- phpdoc-de/reference/strings/functions/ucfirst.xml:1.7 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/ucfirst.xml Wed Oct 17 00:05:47 2007 @@ -1,33 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.3 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.ucfirst" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>ucfirst</refname> - <refpurpose> - Verwandelt das erste Zeichen eines Strings in einen Großbuchstaben - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>ucfirst</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Wandelt das erste Zeichen von <parameter>str</parameter> in einen - Großbuchstaben um, wenn es ein Zeichen des Alphabets ist, und gibt den - veränderten String zurück. - </para> - <para> - Beachten Sie, dass die Zeichen des Alphabets abhängig vom - Wert des gesetzten locale erkannt werden. Ist der Voreinstellung "C" - werden Sonderzeichen wie die deutschen Umlaute (ä etc.) nicht erkannt - und daher nicht umgewandelt. - <example> - <title><function>ucfirst</function>-Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ucfirst"> + <refnamediv> + <refname>ucfirst</refname> + <refpurpose>Verwandelt das erste Zeichen eines Strings in einen Großbuchstaben</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>ucfirst</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Wandelt das erste Zeichen von <parameter>str</parameter> in einen + Großbuchstaben um, wenn es ein Zeichen des Alphabets ist, und gibt den + veränderten String zurück. + </para> + <para> + Beachten Sie, dass die Zeichen des Alphabets abhängig vom + Wert des gesetzten locale erkannt werden. Ist der Voreinstellung "C" + werden Sonderzeichen wie die deutschen Umlaute (ä etc.) nicht erkannt + und daher nicht umgewandelt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den umgewandelten String zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>ucfirst</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $foo = 'hallo welt!'; @@ -38,15 +65,24 @@ $bar = ucfirst(strtolower($bar)); // Hallo welt! ?> ]]> - </programlisting> - </example> - </para> - <para> - Siehe auch <function>strtolower</function>, <function>strtoupper</function> - und <function>ucwords</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strtolower</function></member> + <member><function>strtoupper</function></member> + <member><function>ucwords</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/ucwords.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/ucwords.xml diff -u phpdoc-de/reference/strings/functions/ucwords.xml:1.5 phpdoc-de/reference/strings/functions/ucwords.xml:1.6 --- phpdoc-de/reference/strings/functions/ucwords.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/ucwords.xml Wed Oct 17 00:05:47 2007 @@ -1,35 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.23 --> - <refentry xml:id="function.ucwords" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>ucwords</refname> - <refpurpose> - Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings - in einen Großbuchstaben - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>ucwords</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Gibt einen String zurück, in dem das erste Zeichen eines jeden Wortes - innerhalb von <parameter>str</parameter> in einen Großbuchstaben - umgewandelt wurde, sofern es sich dabei um Buchstaben handelt. - </para> - <simpara> - Als Wort wird hierbei eine Zeichenkette verstanden, die einem - Whitespace (Leerzeichen, Seitenvorschub, Zeilenvorschub, Wagenrücklauf - sowie horizontalem und vertikalem Tabulatorzeichen) folgt. - </simpara> - <para> - <example> - <title><function>ucwords</function>-Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.8 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ucwords"> + <refnamediv> + <refname>ucwords</refname> + <refpurpose>Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings + in einen Großbuchstaben</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>ucwords</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen String zurück, in dem das erste Zeichen eines jeden Wortes + innerhalb von <parameter>str</parameter> in einen Großbuchstaben + umgewandelt wurde, sofern es sich dabei um Buchstaben handelt. + </para> + <para> + Als Wort wird hierbei eine Zeichenkette verstanden, die einem + Whitespace (Leerzeichen, Seitenvorschub, Zeilenvorschub, Wagenrücklauf + sowie horizontalem und vertikalem Tabulatorzeichen) folgt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die modifizierte Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>ucwords</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $foo = 'hallo welt!'; @@ -40,18 +65,29 @@ $bar = ucwords(strtolower($bar)); // Hallo Welt! ?> ]]> - </programlisting> - </example> - </para> - - ¬e.bin-safe; - - <para> - Siehe auch <function>strtoupper</function>, - <function>strtolower</function> und <function>ucfirst</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strtoupper</function></member> + <member><function>strtolower</function></member> + <member><function>ucfirst</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/vfprintf.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/strings/functions/vfprintf.xml diff -u phpdoc-de/reference/strings/functions/vfprintf.xml:1.2 phpdoc-de/reference/strings/functions/vfprintf.xml:1.3 --- phpdoc-de/reference/strings/functions/vfprintf.xml:1.2 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/vfprintf.xml Wed Oct 17 00:05:47 2007 @@ -1,46 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.2 Maintainer: sammywg Status: working --> - <refentry xml:id="function.vfprintf" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>vfprintf</refname> - <refpurpose>Schreibt einen formatierten String in einen Stream</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>vfprintf</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam><type>array</type><parameter>args</parameter></methodparam> - </methodsynopsis> - <simpara> - Schreibt einen der <parameter>Format</parameter>anweisung entsprechenden - String in den im <parameter>handle</parameter> definierten Stream. - Die möglichen <parameter>Format</parameter>-Anweisungen sind in der Funktion - <function>sprintf</function> dokumentiert. - </simpara> - <simpara> - Verhält sich wie <function>fprintf</function>, akzeptiert jedoch ein Array - anstelle einer Gruppe von Werten als Parameter. - </simpara> - <simpara> - Gibt die Länge des formatierten Strings zurück. - </simpara> - <simpara> - Siehe auch <function>printf</function>, - <function>sprintf</function>, - <function>sscanf</function>, <function>fscanf</function>, - <function>vsprintf</function>, und - <function>number_format</function>. - </simpara> - </refsect1> - <refsect1> - <title>Beispiel:</title> - <para> - <example> - <title><function>vfprintf</function>: Integer-Werte mit führenden Nullen</title> - <programlisting role="php"> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.5 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vfprintf"> + <refnamediv> + <refname>vfprintf</refname> + <refpurpose>Schreibt einen formatierten String in einen Stream</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>vfprintf</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam><type>array</type><parameter>args</parameter></methodparam> + </methodsynopsis> + <para> + Schreibt einen der <parameter>Format</parameter>anweisung entsprechenden + String in den im <parameter>handle</parameter> definierten Stream. + </para> + <para> + Verhält sich wie <function>fprintf</function>, akzeptiert jedoch ein Array + anstelle einer Gruppe von Werten als Parameter. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + Die möglichen <parameter>Format</parameter>-Anweisungen sind in der + Funktion <function>sprintf</function> dokumentiert. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>args</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Länge des Ausgabestrings zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>vfprintf</function>: Integer-Werte mit führenden Nullen</title> + <programlisting role="php"> <![CDATA[ <?php if (!($fp = fopen('date.txt', 'w'))) @@ -50,11 +78,27 @@ // schreibt das ISO-formatierte Datum in die Daten date.txt ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>printf</function></member> + <member><function>sprintf</function></member> + <member><function>sscanf</function></member> + <member><function>fscanf</function></member> + <member><function>vsprintf</function></member> + <member><function>number_format</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/vprintf.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/strings/functions/vprintf.xml diff -u phpdoc-de/reference/strings/functions/vprintf.xml:1.3 phpdoc-de/reference/strings/functions/vprintf.xml:1.4 --- phpdoc-de/reference/strings/functions/vprintf.xml:1.3 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/vprintf.xml Wed Oct 17 00:05:47 2007 @@ -1,37 +1,72 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/strings.xml, last change in rev 1.124 --> -<!-- EN-Revision: 1.4 Maintainer: sammywg Status: working --> - <refentry xml:id="function.vprintf" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>vprintf</refname> - <refpurpose>Gibt einen formatierten String zurück</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>vprintf</methodname> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam><type>array</type><parameter>args</parameter></methodparam> - </methodsynopsis> - <simpara> - Zeigt die Werte eines Arrays als formatierten String entsprechend der - <parameter>Format</parameter>anweisungen (siehe Beschreibung der - Formatierungsmöglichkeiten der Funktion <function>sprintf</function>). - </simpara> - <simpara> - Arbeitet wie <function>printf</function>, akzeptiert jedoch ein Array - anstelle mehrerer Werte als Argument. - </simpara> - <simpara> - Gibt die Länge des Ausgabestrings zurück. - </simpara> - <simpara> - Siehe auch <function>printf</function>, <function>sprintf</function>, - <function>vsprintf</function> - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vprintf"> + <refnamediv> + <refname>vprintf</refname> + <refpurpose>Gibt einen formatierten String zurück</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>vprintf</methodname> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam><type>array</type><parameter>args</parameter></methodparam> + </methodsynopsis> + <para> + Zeigt die Werte eines Arrays als formatierten String entsprechend der + <parameter>Format</parameter>anweisungen (siehe Beschreibung der + Formatierungsmöglichkeiten der Funktion <function>sprintf</function>) an. + </para> + <para> + Arbeitet wie <function>printf</function>, akzeptiert jedoch ein Array + anstelle mehrerer Werte als Argument. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>args</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Länge des Ausgabestrings zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>printf</function></member> + <member><function>sprintf</function></member> + <member><function>vsprintf</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/vsprintf.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/strings/functions/vsprintf.xml diff -u phpdoc-de/reference/strings/functions/vsprintf.xml:1.2 phpdoc-de/reference/strings/functions/vsprintf.xml:1.3 --- phpdoc-de/reference/strings/functions/vsprintf.xml:1.2 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/vsprintf.xml Wed Oct 17 00:05:47 2007 @@ -1,34 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./en/functions/strings.xml, last change in rev 1.124 --> -<!-- EN-Revision: 1.4 Maintainer: sammywg Status: working --> - <refentry xml:id="function.vsprintf" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>vsprintf</refname> - <refpurpose>Gibt einen formatierten String zurück</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>vsprintf</methodname> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam><type>array</type><parameter>args</parameter></methodparam> - </methodsynopsis> - <simpara> - Gibt Array-Werte als formatierten String entsprechend der - <parameter>Format</parameter>anweisung (siehe Beschreibung der - Formatierungsmöglichkeiten der Funktion <function>sprintf</function>) - zurück. - </simpara> - <simpara> - Verhält sich wie <function>sprintf</function>, akzeptiert jedoch ein - Array anstelle mehrerer Werte als Parameter. - </simpara> - <simpara> - Siehe auch <function>sprintf</function> und <function>vprintf</function> - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vsprintf"> + <refnamediv> + <refname>vsprintf</refname> + <refpurpose>Gibt einen formatierten String zurück</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>vsprintf</methodname> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam><type>array</type><parameter>args</parameter></methodparam> + </methodsynopsis> + <para> + Verhält sich wie <function>sprintf</function>, akzeptiert jedoch ein + Array anstelle mehrerer Werte als Parameter. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>args</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt Array-Werte als formatierten String entsprechend der + <parameter>Format</parameter>anweisung (siehe Beschreibung der + Formatierungsmöglichkeiten der Funktion <function>sprintf</function>) + zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>sprintf</function></member> + <member><function>vprintf</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/wordwrap.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/wordwrap.xml diff -u phpdoc-de/reference/strings/functions/wordwrap.xml:1.5 phpdoc-de/reference/strings/functions/wordwrap.xml:1.6 --- phpdoc-de/reference/strings/functions/wordwrap.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/wordwrap.xml Wed Oct 17 00:05:47 2007 @@ -1,97 +1,161 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.13 Maintainer: sammywg Status: working --> - <refentry xml:id="function.wordwrap" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>wordwrap</refname> - <refpurpose> - Bricht einen String nach einer bestimmten Anzahl Zeichen mittels - des angegebenen Trennzeichens um. - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>string</type><methodname>wordwrap</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>width</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>break</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>cut</parameter></methodparam> - </methodsynopsis> - <para> - Bricht den String <parameter>str</parameter> an der mittels - des optionalen Parameters <parameter>width</parameter> angegebenen - Position um. Als Zeilenumbruch wird der (optionale) Parameter - <parameter>break</parameter> verwendet. - </para> - <para> - Die Funktion <function>wordwrap</function> bricht einen String - automatisch nach dem 75sten Zeichen unter Verwendung des - Steuerzeichens '<literal>\n</literal>' (neue Zeile) um, sofern die - Parameter <parameter>width</parameter> und/oder - <parameter>break</parameter> nicht angegeben sind. - </para> - <para> - Ist für <parameter>cut</parameter> der Wert 1 angegeben, wird der - String immer an der vorgegebenen Position umgebrochen. Ist also ein - Wort länger als die vorgegeben, wird der Zeilumbruch innerhalb des Wortes - eingefügt (siehe zweites Beispiel). - <note> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.17 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.wordwrap"> + <refnamediv> + <refname>wordwrap</refname> + <refpurpose>Bricht einen String nach einer bestimmten Anzahl Zeichen um</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>wordwrap</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>width</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>break</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>cut</parameter></methodparam> + </methodsynopsis> + <para> + Bricht einen String nach einer bestimmten Anzahl Zeichen mittels eines + angegebenen Trennzeichens um. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>width</parameter></term> + <listitem> + <para> + Die Spaltenbreite des Umbruchs. Standardwert sind 75 Zeichen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>break</parameter></term> + <listitem> + <para> + Der optionale Parameter <parameter>break</parameter> wird als Zeichen(kette) + für den Zeilenumbruch verwendet. Standardwert ist '<literal>\n</literal>'. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>cut</parameter></term> + <listitem> <para> - Der optionale Parameter <parameter>cut</parameter> wurde in PHP 4.0.3 - eingeführt. + Wenn der Parameter <parameter>cut</parameter> auf &true; gesetzt ist, + wird die Zeichenkette immer nach der angegebenen Länge umgebrochen. + Wenn sie also ein Wort haben, das länger als die angegebene + Maximallänge ist, wird der Umbruch im Wort selbst durchgeführt (siehe + zweites Beispiel). </para> - </note> - </para> - <example> - <title><function>wordwrap</function>-Beispiel:</title> - <programlisting role="php"> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die übergebene Zeichenkette zurück, die an der angegebenen Trennstelle + umgebrochen wurde. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.0.3</entry> + <entry> + Der optionale Parameter <parameter>cut</parameter> wurde hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>wordwrap</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ $text = "Der schnelle braune Fuchs sprang über den faulen Hund."; $neuertext = wordwrap( $text, 20, "<br />\n" ); echo $neuertext; ]]> - </programlisting> - <para> - Dieses Beispiel gibt aus: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ -Der schnelle braune<br /> -Fuchs sprang über<br /> +Der schnelle braune<br /> +Fuchs sprang über<br /> den faulen Hund. ]]> - </screen> - </example> - <example> - <title><function>wordwrap</function>-Beispiel:</title> - <programlisting role="php"> + </screen> + </example> + <example> + <title><function>wordwrap</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ $text = "Ein sehr langes Wooooooooooort."; -$neuertext = wordwrap($text, 8, "\n", 1); +$neuertext = wordwrap($text, 8, "\n", true); echo "$neuertext\n"; ]]> - </programlisting> - <para> - Dieses Beispiel gibt aus: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Ein sehr langes Wooooooo oooort. ]]> - </screen> - </example> - <para> - Siehe auch <function>nl2br</function> und - <function>chunk_split</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>nl2br</function></member> + <member><function>chunk_split</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/zlib/configure.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/zlib/configure.xml diff -u phpdoc-de/reference/zlib/configure.xml:1.3 phpdoc-de/reference/zlib/configure.xml:1.4 --- phpdoc-de/reference/zlib/configure.xml:1.3 Sat Jun 23 13:21:53 2007 +++ phpdoc-de/reference/zlib/configure.xml Wed Oct 17 00:05:47 2007 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: nobody Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: sammywg Status: ready --> <section xml:id="zlib.installation" xmlns="http://docbook.org/ns/docbook"> &reftitle.install; <para> - Die Unterstützung für Zlib ist in PHP nicht standardmäßig aktiviert. Es ist + Die Unterstützung für zlib ist in PHP nicht standardmäßig aktiviert. Es ist erforderlich, die Option <option role="configure">--with-zlib[=DIR]</option> beim Kompilieren von PHP anzugeben. </para> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/zlib/reference.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/zlib/reference.xml diff -u phpdoc-de/reference/zlib/reference.xml:1.5 phpdoc-de/reference/zlib/reference.xml:1.6 --- phpdoc-de/reference/zlib/reference.xml:1.5 Sat Jun 23 13:21:53 2007 +++ phpdoc-de/reference/zlib/reference.xml Wed Oct 17 00:05:47 2007 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.16 Maintainer: nobody Status: ready --> -<!-- CREDITS: nohn --> -<!-- Purpose: compression --> -<!-- Membership: bundled --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.18 Maintainer: sammywg Status: ready --> <reference xml:id="ref.zlib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Zlib Komprimierungsfunktionen</title> @@ -13,8 +10,8 @@ <section xml:id="zlib.intro"> &reftitle.intro; <para> - Dieses Modul gibt Ihnen die Möglichkeit, transparent gzip (.gz) - - komprimierte Dateien zu lesen und zu schreiben. Hierfür bietet diese + Dieses Modul gibt Ihnen die Möglichkeit, transparent gzip-komprimierte + Dateien (*.gz) zu lesen und zu schreiben. Hierfür bietet die Erweiterung die Versionen der meisten <link linkend="ref.filesystem">Dateisystem</link>-Funktionen, die mit gzip-komprimierten (und unkomprimierten) Dateien, jedoch nicht mit @@ -23,7 +20,7 @@ <note> <para> Mit Version 4.0.4 wurde ein fopen-wrapper für .gz-Dateien eingeführt, - so dass Sie die spezielle <filename>zlib:</filename>-URL verwenden + so dass Sie den speziellen <filename>zlib:</filename>-URL verwenden können, um auf komprimierte Dateien transparent über die f*()-Dateifunktionen zuzugreifen. Beim Aufruf von <function>fopen</function> müssen Sie dazu lediglich vor dem Dateinamen @@ -38,7 +35,7 @@ <filename>compress.zlib://</filename> geändert, um Konflikte mit Dateinamen zu vermeiden die ':' Zeichen enthalten. Die <literal>fopencookie()</literal> Funktion wird nicht mehr benötigt. Mehr - Information hierzu finden Sie im Abschnitt über + Information hierzu finden Sie im Abschnitt über <xref linkend="wrappers.compression" />. </para> <para> @@ -62,7 +59,10 @@ <section xml:id="zlib.resources"> &reftitle.resources; - &no.resource; + <para> + Die Extension definiert eine Filepointer-Ressource, die von + <function>gzopen</function> zurückgegeben wird. + </para> </section> &reference.zlib.constants; @@ -70,8 +70,8 @@ <section xml:id="zlib.examples"> &reftitle.examples; <para> - Dieses Beispiel öffnet eine temporäre Datei und schreibt einen Test - String in die Datei, dann wird der Inhalt dieser Datei zweimal ausgegeben. + Dieses Beispiel öffnet eine temporäre Datei und schreibt einen Teststring + in die Datei, dann wird der Inhalt dieser Datei zweimal ausgegeben. </para> <example> <title>Ein kleines Beispiel zu Zlib</title> @@ -95,7 +95,7 @@ // Datei zum Lesen öffnen $zp = gzopen($filename, "r"); -// 3 Zeichen ausgeben +// 3 Zeichen einlesen und ausgeben echo gzread($zp, 3); // Inhalt der Datei ausgeben und die Datei schließen http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/zlib/constants.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/zlib/constants.xml +++ phpdoc-de/reference/zlib/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: sammywg Status: ready --> <section xml:id="zlib.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>FORCE_GZIP</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>FORCE_DEFLATE</constant> (<type>integer</type>) </term> <listitem> <simpara> </simpara> </listitem> </varlistentry> </variablelist> </section> <!-- 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: --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/zlib/ini.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/zlib/ini.xml +++ phpdoc-de/reference/zlib/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready --> <section xml:id="zlib.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; <para> Die zlib-Erweiterung gibt Ihnen die Möglichkeit, Ihre Seiten on-the-fly transparent zu komprimieren, wenn der Browser dies unterstützt. Dafür gibt es drei Optionen in der <link linkend="configuration.file">Konfigurationsdatei</link> &php.ini;. <table> <title>Zlib-Konfigurationsoptionen</title> <tgroup cols="4"> <thead> <row> <entry>Name</entry> <entry>Standardwert</entry> <entry>Veränderbar</entry> <entry>Changelog</entry> </row> </thead> <tbody> <row> <entry>zlib.output_compression</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> <entry>Verfügbar seit PHP 4.0.5.</entry> </row> <row> <entry>zlib.output_compression_level</entry> <entry>"-1"</entry> <entry>PHP_INI_ALL</entry> <entry>Verfügbar seit PHP 4.3.0.</entry> </row> <row> <entry>zlib.output_handler</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> <entry>Verfügbar seit PHP 4.3.0.</entry> </row> </tbody> </tgroup> </table> &ini.php.constants; </para> &ini.descriptions.title; <para> <variablelist> <varlistentry xml:id="ini.zlib.output-compression"> <term> <parameter>zlib.output_compression</parameter> <type>boolean</type>/<type>integer</type> </term> <listitem> <para> Wenn diese Option in der &php.ini; oder der Apachekonfiguration auf "On" gesetzt ist, werden die Seiten komprimiert, wenn der Browser einen "Accept-Encoding: gzip"- oder einen "deflate"-Header sendet. Zu den normalerweise vom Server gesendeten Headern werden nun "Content-Encoding: gzip" (respektive "deflate") und "Vary: Accept-Encoding" hinzugefügt. Zur Laufzeit kann die Option nur gesetzt werden, bevor irgendeine Ausgabe gesendet wurde. </para> <para> Diese Option akzeptiert auch Integerwerte anstelle des boolschen On/Off, wenn Sie diese verwenden, können Sie die Ausgabepuffergröße festlegen (der Standardwert ist 4KB). </para> <note> <para> <link linkend="ini.output-handler">output_handler</link> muss leer sein, wenn diese Option den Wert "On" hat! Verwenden Sie statt dessen zlib.output_handler. </para> </note> </listitem> </varlistentry> <varlistentry xml:id="ini.zlib.output-compression-level"> <term> <parameter>zlib.output_compression_level</parameter> <type>integer</type> </term> <listitem> <para> Der Kompressionsgrad für die transparente Ausgabekomprimierung. </para> </listitem> </varlistentry> <varlistentry xml:id="ini.zlib.output-handler"> <term> <parameter>zlib.output_handler</parameter> <type>string</type> </term> <listitem> <para> Sie können keine zusätzlichen Outputhandler angeben, wenn Sie zlib.output_compression aktiviert haben. Diese Einstellung tut das Gleiche wie <link linkend="ini.output-handler">output_handler</link>, allerdings in einer anderen Reihenfolge. </para> </listitem> </varlistentry> </variablelist> </para> </section> <!-- 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 -->