gzgets

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

gzgetsObtém uma linha de um ponteiro de arquivo

Descrição

gzgets(resource $stream, ?int $length = null): string|false

Obtém uma (descomprimida) string até o tamanho length - 1 bytes lidos a partir do ponteiro de arquivo dado. A leitura termina quando length - 1 bytes tiverem sido lidos, em uma nova liha ou em EOF (o que vier primeiro).

Parâmetros

stream

O ponteiro do arquivo deve ser válido, e deve apontar para um arquivo aberto corretamente com gzopen().

length

O tamanho dos dados a pegar.

Valor Retornado

A string descomprimida, ou false em caso de erro.

Registro de Alterações

Versão Descrição
8.0.0 length pode ser null; anteriormente, o padrão era 1024.

Exemplos

Example #1 gzgets() example

<?php
$handle = gzopen('somefile.gz', 'r');
while (!gzeof($handle)) {
   $buffer = gzgets($handle, 4096);
   echo $buffer;
}
gzclose($handle);
?>

Veja Também

  • gzopen() - Abre arquivo gz
  • gzgetc() - Obtém caractere de um ponteiro de arquivo gz
  • gzwrite() - Escrita segura para binário em arquivo-gz