sean Sat Mar 3 18:24:01 2007 UTC
Modified files:
/phpdoc/en/reference/filesystem/functions fwrite.xml
Log:
add note about atomic fwrites in append mode
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/filesystem/functions/fwrite.xml?r1=1.14&r2=1.15&diff_format=u
Index: phpdoc/en/reference/filesystem/functions/fwrite.xml
diff -u phpdoc/en/reference/filesystem/functions/fwrite.xml:1.14
phpdoc/en/reference/filesystem/functions/fwrite.xml:1.15
--- phpdoc/en/reference/filesystem/functions/fwrite.xml:1.14 Sat Feb 3
08:13:44 2007
+++ phpdoc/en/reference/filesystem/functions/fwrite.xml Sat Mar 3 18:24:00 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.14 $ -->
+<!-- $Revision: 1.15 $ -->
<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
<refentry id="function.fwrite">
<refnamediv>
@@ -41,6 +41,17 @@
<function>fopen</function> mode parameter.
</para>
</note>
+ <note>
+ <para>
+ If <parameter>handle</parameter> was <function>fopen</function>ed in
+ append mode, <function>fwrite</function>s are atomic (unless the size of
+ <parameter>string</parameter> exceeds the filesystem's block size, on some
+ platforms, and as long as the file is on a local filesystem). That is,
+ there is no need to <function>flock</function> a resource before calling
+ <function>fwrite</function>; all of the data will be written without
+ interruption.
+ </para>
+ </note>
<para>
<example>
<title>A simple <function>fwrite</function> example</title>
