svn: /phpdoc/de/trunk/reference/filesystem/functions/ fscanf.xml

From: Date: Fri, 06 Jul 2012 22:08:01 +0000
Subject: svn: /phpdoc/de/trunk/reference/filesystem/functions/ fscanf.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-4283@lists.php.net to get a copy of this message
nikic Fri, 06 Jul 2012 22:08:01 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=326508 Log: Fix Doc Bug #62459 [DE] Missing hint for fscanf Bug: https://bugs.php.net/62459 (Open) [DE] Missing hint for fscanf Changed paths: U phpdoc/de/trunk/reference/filesystem/functions/fscanf.xml Modified: phpdoc/de/trunk/reference/filesystem/functions/fscanf.xml =================================================================== --- phpdoc/de/trunk/reference/filesystem/functions/fscanf.xml 2012-07-06 21:47:09 UTC (rev 326507) +++ phpdoc/de/trunk/reference/filesystem/functions/fscanf.xml 2012-07-06 22:08:01 UTC (rev 326508) @@ -1,79 +1,156 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision$ --> -<!-- EN-Revision: n/a Maintainer: nobody Status: ready --> - <refentry xml:id="function.fscanf" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>fscanf</refname> - <refpurpose>Interpretiert den Input einer Datei entsprechend einem - angegebenen Format </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>mixed</type><methodname>fscanf</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam> - </methodsynopsis> - <para> - Die Funktion <function>fscanf</function> ist - <function>sscanf</function> ähnlich, wobei sie ihren Input aus - der mit <parameter>handle</parameter> angegebenen Datei nimmt, und - entsprechend dem angegebenen <parameter>format</parameter> - interpretiert. Sind nur 2 Parameter angegeben, werden die analysierten - Werte als Array zurückgegeben. Werden auch optionale Parameter - übergeben, gibt die Funktion die Anzahl der ermittelten Werte zurück. - Die optionalen Parameter müssen referenziert übergeben werden. - </para> - <para> - Irgendwelche Whitespace-Zeichen (z.B. Leerzeichen, Tabulator, etc.) - im Format String gelten mit irgendwelchen Whitespace-Zeichen des - Input-Streams als übereinstimmend. Das heißt, dass auch ein - Tabulator <literal>\t</literal> im Format String mit einem einzigen - Leerzeichen im Input-Stream als übereinstimmend gelten kann. - </para> - <para> - <example> - <title><function>fscanf</function></title> - <programlisting role="php"> +<!-- EN-Revision: 297028 Maintainer: nikic Status: ready --> +<refentry xml:id="function.fscanf" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>fscanf</refname> + <refpurpose>Interpretiert den Input einer Datei entsprechend einem + angegebenen Format</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>fscanf</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter role="reference">...</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion <function>fscanf</function> ist ähnlich zu + <function>sscanf</function>, wobei sie ihren Input aus + der mit <parameter>handle</parameter> angegebenen Datei liest, und + entsprechend dem angegebenen <parameter>format</parameter> + interpretiert. Der <parameter>format</parameter> Parameter is unter + der <function>sprintf</function> Funktion näher dokumentiert. + </para> + <para> + Beliebige Whitespace-Zeichen (z.B. Leerzeichen, Tabulator, etc.) + im Format String gelten mit beliebigen Whitespace-Zeichen des + Input-Streams als übereinstimmend. Das heißt, dass auch ein + Tabulator <literal>\t</literal> im Format String mit einem einzigen + Leerzeichen im Input-Stream als übereinstimmend gelten kann. + </para> + <para> + Jeder <function>fscanf</function> Aufruf liest eine Zeile aus der Datei aus. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + &fs.file.pointer; + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>format</parameter></term> + <listitem> + <para> + Das erwartete Format, wie es in der <function>sprintf</function> + Dokumentation beschrieben ist. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>...</parameter></term> + <listitem> + <para> + Optionale als Referenz übergebene Variablen, in welche die geparsten Werte + geschrieben werden sollen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Wenn nur zwei Parameter an die Funktion übergeben wurden, werden die geparseten + Werte in einem Array zurückgegeben. Andernfalls gibt die Funktion die anzahl + der zugewiesenen Werte zurück. Die optionalen Parameter müssen per Referenz + übergeben werden. + </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.3.0</entry> + <entry> + In früheren Versionen wurden maximal 512 Zeichen pro Aufruf eingelesen. + Ab PHP 4.3.0 werden beliebig lange Zeile eingelesen und interpretiert. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>fscanf</function> Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -$handle = fopen ("users.txt","r"); -while ($userinfo = fscanf ($handle, "%s\t%s\t%s\n")) { +$handle = fopen("users.txt", "r"); +while ($userinfo = fscanf($handle, "%s\t%s\t%s\n")) { list ($name, $profession, $countrycode) = $userinfo; - //... Tue etwas mit den Werten + // Tue etwas mit den Werten ... } fclose($handle); ?> ]]> - </programlisting> - </example> - <example> - <title>users.txt</title> - <screen> + </programlisting> + </example> + </para> + <para> + <example> + <title>Inhalt der users.txt Datei</title> + <programlisting role="txt"> <![CDATA[ javier argonaut pe hiroshi sculptor jp robert slacker us luigi florist it ]]> - </screen> - </example> - </para> - <note> - <simpara> - Vor PHP 4.3.0 war die maximale Anzahl der von der Datei eingelesenen - Zeichen 512 (oder bis zu dem ersten \n, was zuerst eintrat). - Seit PHP 4.3.0 werden beliebig lange Zeilen gelesen und interprtiert. - </simpara> - </note> - <para> - Siehe auch <function>fread</function>, <function>fgets</function>, - <function>fgetss</function>, <function>sscanf</function>, - <function>printf</function>, und <function>sprintf</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fread</function></member> + <member><function>fgets</function></member> + <member><function>fgetss</function></member> + <member><function>sscanf</function></member> + <member><function>printf</function></member> + <member><function>sprintf</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables:

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