gzread

Binary-safe gz-file read

Description

stringfalse gzread(resource $stream, int $length)

gzread reads up to length bytes from the given gz-file pointer. Reading stops when length (uncompressed) bytes have been read or EOF is reached, whichever comes first.

Parameters

stream

The gz-file pointer. It must be valid, and must point to a file successfully opened by gzopen.

length

The number of bytes to read.

Return Values

The data that have been read, or false on failure.

Changelog

Version Description
7.4.0 This functions returns false on failure now; previously 0 was returned.

Examples

Example #1 gzread example

<?php
// get contents of a gz-file into a string
$filename = "/usr/local/something.txt.gz";
$zd = gzopen($filename, "r");
$contents = gzread($zd, 10000);
gzclose($zd);
?>

See Also

  • gzwrite
  • gzopen
  • gzgets
  • gzgetss
  • gzfile
  • gzpassthru