fwrite
    (PHP 3, PHP 4, PHP 5)
fwrite -- Binary-safe file write
Description
int 
fwrite ( resource handle, string string [, int length] )
     fwrite() writes the contents of
     string to the file stream pointed to by
     handle. If the length
     argument is given, writing will stop after
     length bytes have been written or the end
     of string is reached, whichever comes
     first.
    
     fwrite() returns the number of bytes
     written, or FALSE on error.
    
     Note that if the length argument is given,
     then the magic_quotes_runtime
     configuration option will be ignored and no slashes will be
     stripped from string.
    
Note: 
      On systems which differentiate between binary and text files 
      (i.e. Windows) the file must be opened with 'b' included in
      fopen() mode parameter.
     
     
| Example 1. A simple fwrite() example | 
<?php$filename = 'test.txt';
 $somecontent = "Add this to the file\n";
 
 // Let's make sure the file exists and is writable first.
 if (is_writable($filename)) {
 
 // In our example we're opening $filename in append mode.
 // The file pointer is at the bottom of the file hence
 // that's where $somecontent will go when we fwrite() it.
 if (!$handle = fopen($filename, 'a')) {
 echo "Cannot open file ($filename)";
 exit;
 }
 
 // Write $somecontent to our opened file.
 if (fwrite($handle, $somecontent) === FALSE) {
 echo "Cannot write to file ($filename)";
 exit;
 }
 
 echo "Success, wrote ($somecontent) to file ($filename)";
 
 fclose($handle);
 
 } else {
 echo "The file $filename is not writable";
 }
 ?>
 | 
 | 
    
     See also fread(),
     fopen(),
     fsockopen(),
     popen(), and
     file_put_contents().