From 460e5679814a65fee63a1d622928a3ade9bb711b Mon Sep 17 00:00:00 2001
From: Jakub Vrana <vrana@php.net>
Date: Thu, 28 May 2009 09:00:55 +0000
Subject: [PATCH] Network stream

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@281274 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/filesystem/functions/fwrite.xml | 28 +++++++++++++++++++----
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/reference/filesystem/functions/fwrite.xml b/reference/filesystem/functions/fwrite.xml
index a847491d5a..300776d4e6 100644
--- a/reference/filesystem/functions/fwrite.xml
+++ b/reference/filesystem/functions/fwrite.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.18 $ -->
+<!-- $Revision: 1.19 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fwrite">
  <refnamediv>
   <refname>fwrite</refname>
@@ -71,6 +71,28 @@
 
  <refsect1 role="notes">
   &reftitle.notes;
+  <note>
+   <para>
+    Writing to a network stream may end before the whole string is written.
+    Return value of <function>fwrite</function> may be checked:
+    <programlisting role="php">
+<![CDATA[
+<?php
+function fwrite_stream($fp, $string) {
+    for ($written = 0; $written < strlen($string); $written += $fwrite) {
+        $fwrite = fwrite($fp, substr($string, $written));
+        if (!$fwrite) {
+            return $fwrite;
+        }
+    }
+    return $written;
+}
+?>
+]]>
+    </programlisting>
+   </para>
+  </note>
+  
   <note>
    <para>
     On systems which differentiate between binary and text files
@@ -92,9 +114,7 @@
   <note>
    <para>
     If writing twice to the file pointer, then the data will be appended to 
-    the end of the file content, meaning that the example below wouldn't work 
-    as expected:
-
+    the end of the file content:
         <programlisting role="php">
 <![CDATA[
 <?php