fwrite
Binary-safe file write
&reftitle.description;
intfalsefwrite
resourcestream
stringdata
intnulllength&null;
fwrite writes the contents of
data to the file stream pointed to by
stream.
&reftitle.parameters;
stream
&fs.file.pointer;
data
The string that is to be written.
length
If length is an &integer;, writing will stop
after length bytes have been written or the
end of data is reached, whichever comes first.
&reftitle.returnvalues;
fwrite returns the number of bytes
written, &return.falseforfailure;.
&reftitle.errors;
fwrite raises E_WARNING on failure.
&reftitle.changelog;
&Version;
&Description;
8.0.0
length is nullable now.
&reftitle.examples;
A simple fwrite example
]]>
&reftitle.notes;
Writing to a network stream may end before the whole string is written.
Return value of fwrite may be checked:
]]>
On systems which differentiate between binary and text files
(i.e. Windows) the file must be opened with 'b' included in
fopen mode parameter.
If stream was fopened in
append mode, fwrites are atomic (unless the size of
data 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 flock a resource before calling
fwrite; all of the data will be written without
interruption.
If writing twice to the file pointer, then the data will be appended to
the end of the file content:
]]>
&reftitle.seealso;
fread
fopen
fsockopen
popen
file_get_contents
pack