svn: /phpdoc/de/trunk/reference/filesystem/functions/ fscanf.xml
| From: | Nikita Popov | 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: