fwrite

(PHP 3, PHP 4 , PHP 5)

fwrite -- バイナリ・モードによるファイル書き込み

説明

int fwrite ( resource handle, string string [, int length])

fwrite()stringの内容を handleが指しているファイル・ストリームに書き込み ます。lengthパラメータが与えられている場合、 lengthバイト数分の書き込みが完了したか、 stringが終わりに達したかのいずれか早い方の 事象により書き込みは中止されます。

fwrite()は書き込んだバイト数、またはエラー時に FALSE を返します。

length パラメータが指定されている場合、 magic_quotes_runtime 構成オプションは無視され、stringからの スラッシュ文字の取り除きは行われないことに注意して下さい。

注意: (Windowsのように)バイナリとテキストファイルの形式が異なるシステ ムにおいては、ファイルをオープンする際に fopen()の mode パラメータに 'b' を指定する必 要があります。

例 1. fwrite の簡単な例

<?php
$filename
= 'test.txt';
$somecontent = "Add this to the file\n";

// ファイルが存在しかつ書き込み可能かどうか確認します
if (is_writable($filename)) {

    
// この例では$filenameを追加モードでオープンします。
    // ファイルポインタはファイルの終端になりますので
    // そこがfwrite()で$somecontentが追加される位置になります。
    
if (!$handle = fopen($filename, 'a')) {
         print
"Cannot open file ($filename)";
         exit;
    }

    
// オープンしたファイルに$somecontentを書き込みます
    
if (!fwrite($handle, $somecontent)) {
        print
"Cannot write to file ($filename)";
        exit;
    }
    
    print
"Success, wrote ($somecontent) to file ($filename)";
    
    
fclose($handle);
    
} else {
    print
"The file $filename is not writable";
}
?>

fread(), fopen(), fsockopen(), popen(), fputs()も参照下さい。