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')) {
         echo
"Cannot open file ($filename)";
         exit;
    }

    
// オープンしたファイルに$somecontentを書き込みます
    
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";
}
?>

fread(), fopen(), fsockopen(), popen(), file_put_contents() も参照ください。