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

Modified: phpdoc/de/trunk/reference/filesystem/functions/fread.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/fread.xml	2010-05-05 12:45:51 UTC (rev 299019)
+++ phpdoc/de/trunk/reference/filesystem/functions/fread.xml	2010-05-05 13:29:12 UTC (rev 299020)
@@ -1,70 +1,198 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: nobody Status: ready -->
-  <refentry xml:id="function.fread" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>fread</refname>
-    <refpurpose>Liest Binärdaten aus einer Datei</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Beschreibung</title>
-     <methodsynopsis>
-      <type>string</type><methodname>fread</methodname>
-      <methodparam><type>resource</type><parameter>handle</parameter></methodparam>
-      <methodparam><type>int</type><parameter>length</parameter></methodparam>
-     </methodsynopsis>
-    <simpara>
-     <function>fread</function> liest <parameter>length</parameter> Bytes
-     vom Dateizeiger <parameter>handle</parameter>. Das Lesen wird beendet, wenn
-     <parameter>length</parameter> Bytes gelesen oder EOF (end of file bzw.
-     Dateiende) erreicht wurde (was eben früher zutrifft).
+<!-- EN-Revision: 297028 Maintainer: simp Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fread">
+ <refnamediv>
+  <refname>fread</refname>
+  <refpurpose>Liest Binärdaten aus einer Datei</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>fread</methodname>
+   <methodparam><type>resource</type><parameter>handle</parameter></methodparam>
+   <methodparam><type>int</type><parameter>length</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>fread</function> liest bis zu
+   <parameter>length</parameter> Bytes vom Dateizeiger
+   <parameter>handle</parameter>. Das Lesen wird beendet, sobald
+   eine der folgenden Bedingungen eintritt:
+   <itemizedlist>
+    <listitem>
+     <simpara>
+      <parameter>length</parameter> Bytes wurden gelesen
      </simpara>
-    <para>
-     <informalexample>
-      <programlisting role="php">
+    </listitem>
+    <listitem>
+     <simpara>
+      Das Dateiende (EOF, end of file) wurde erreicht
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      Ein Paket wird verfügbar (Bei Netzwerk-Streams)
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      8192 Bytes wurden gelesen (nachdem ein Userspace-Stream
+      geöffnet wurde)
+     </simpara>
+    </listitem>
+   </itemizedlist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>handle</parameter></term>
+     <listitem>
+      &fs.file.pointer;
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>length</parameter></term>
+     <listitem>
+      <para>
+       Bis zu <parameter>length</parameter> Bytes lesen.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Gibt die ausgelesene Zeichenkette zurück. &return.falseforfailure;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Ein einfaches <function>fread</function>-Beispiel</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 // liest den Inhalt einer Datei in einen String
-$filename = "/usr/local/simi.txt";
-$handle = fopen ($filename, "r");
-$contents = fread ($handle, filesize ($filename));
-fclose ($handle);
+$filename = "/usr/local/etwas.txt";
+$handle = fopen($filename, "r");
+$contents = fread($handle, filesize($filename));
+fclose($handle);
 ?>
 ]]>
-      </programlisting>
-     </informalexample>
-    </para>
-    <note>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>Ein <function>fread</function>-Beispiel mit einer Binärdatei</title>
+    <warning>
      <para>
-      Auf Systemen, welche zwischen Binär- und Textdateien (z.B. Windows)
+      Auf Systemen, welche zwischen Binär- und Textdateien (z.B. Windows)
       unterscheiden, muss die Datei mit 'b' im <function>fopen</function>
-      Mode-Parameter geöffnet werden.
+      Mode-Parameter geöffnet werden.
      </para>
-    </note>
-    <para>
-     <informalexample>
-      <programlisting role="php">
+    </warning>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $filename = "c:\\files\\somepic.gif";
-$handle = fopen ($filename, "rb");
-$contents = fread ($handle, filesize ($filename));
-fclose ($handle);
+$handle = fopen($filename, "rb");
+$contents = fread($handle, filesize($filename));
+fclose($handle);
 ?>
 ]]>
-      </programlisting>
-     </informalexample>
-    </para>
-    <simpara>
-     Siehe auch <function>fwrite</function>, <function>fopen</function>,
-     <function>fsockopen</function>, <function>popen</function>,
-     <function>fgets</function>, <function>fgetss</function>,
-     <function>fscanf</function>, <function>file</function> und
-     <function>fpassthru</function>.
-    </simpara>
-   </refsect1>
-  </refentry>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title><function>fread</function>-Beispiele für entfernte Dateien</title>
+    <warning>
+     <para>
+      Wenn aus etwas gelesen werden soll, was keine normale lokale Datei ist,
+      wie etwa Streams von
+      <link linkend="features.remote-files">entfernten Dateien</link> oder von
+      <function>popen</function> und <function>fsockopen</function>, so wird
+      das Lesen beendet sobald ein Paket verfügbar ist. Das bedeutet, dass man
+      die Daten in Stücken sammeln muss. Dies wird im unteren Beispiel
+      gezeigt.
+     </para>
+    </warning>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Für PHP5 und höher
+$handle = fopen("http://www.example.com/", "rb");
+$contents = stream_get_contents($handle);
+fclose($handle);
+?>
+]]>
+    </programlisting>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$handle = fopen("http://www.example.com/", "rb");
+$contents = '';
+while (!feof($handle)) {
+  $contents .= fread($handle, 8192);
+}
+fclose($handle);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>

+<refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Wenn man nur den Inhalt einer Datei in eine Zeichenkette lesen will,
+    so sollte man <function>file_get_contents</function> verwenden, da dies
+    eine bessere Performance hat als der obige Code.
+   </para>
+  </note>
+  <note>
+   <para>
+    Beachten Sie, dass <function>fread</function> an der aktuellen Position
+    im Dateizeiger zu lesen beginnt. Verwenden Sie <function>ftell</function>,
+    um herauszufinden wo dieser Zeiger steht und die Funktion
+    <function>rewind</function>, um den Zeiger zurückzustellen.
+   </para>
+  </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>fwrite</function></member>
+    <member><function>fopen</function></member>
+    <member><function>fsockopen</function></member>
+    <member><function>popen</function></member>
+    <member><function>fgets</function></member>
+    <member><function>fgetss</function></member>
+    <member><function>fscanf</function></member>
+    <member><function>file</function></member>
+    <member><function>fpassthru</function></member>
+    <member><function>ftell</function></member>
+    <member><function>rewind</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -76,7 +204,7 @@
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil