gzread

(PHP 4, PHP 5, PHP 7, PHP 8)

gzreadBinary-safe gz-file read

Description

gzread(resource$stream, int$length): string|false

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

VersionDescription
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

To Top