gzwrite
(PHP 4, PHP 5, PHP 7)
gzwrite — バイナリセーフな gz ファイル書き込み
説明
gzwrite
( resource $stream
, string $data
[, int|null $length
= null
] ) : int|false
gzwrite() は data
の内容を与えられた gz ファイルに書き込みます。
パラメータ
stream
gz ファイルポインタを指定します。これは有効なファイルポインタであり、 かつ、gzopen() によりオープンできたファイルを指している必要があります。
data
書き込む文字列を指定します。
length
書き込む解凍されたバイト数を指定します。 もし指定された場合、
length
バイトのデータが書き込まれたか、data
の終わりに達した時に 書き込みは終了します。注意:
引数
length
が指定された場合、 magic_quotes_runtime 設定オプションは無視されてdata
から スラッシュが取り除かれなくなることに注意してください。
変更履歴
バージョン | 説明 |
---|---|
8.0.0 | length は、nullable になりました。
これより前のバージョンでは、デフォルト値は |
7.4.0 | この関数は、失敗時に false を返すようになりました。
これより前のバージョンでは、 |
返り値
与えられた gz ファイルストリームに書き込まれた (解凍された)
バイト数を返します。失敗した場合に false
を返します
例
例1 gzwrite() の例
<?php$string = 'Some information to compress';$gz = gzopen('somefile.gz','w9');gzwrite($gz, $string);gzclose($gz);?>