array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.stream-get-line.php', 1 => 'stream_get_line', 2 => 'Obtém uma linha do recurso do fluxo até um delimitador informado', ), 'up' => array ( 0 => 'ref.stream.php', 1 => 'Funções de Fluxo', ), 'prev' => array ( 0 => 'function.stream-get-filters.php', 1 => 'stream_get_filters', ), 'next' => array ( 0 => 'function.stream-get-meta-data.php', 1 => 'stream_get_meta_data', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/stream/functions/stream-get-line.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

stream_get_line

(PHP 5, PHP 7, PHP 8)

stream_get_line — Obtém uma linha do recurso do fluxo até um delimitador informado

Descrição

stream_get_line(resource $stream, int $length, string $ending = ""): string|false

Obtém uma linha do manipulador informado.

A leitura termina quando o número de bytes especificados em length tiverem sido lidos, ou quando a string não vazia especificada por ending for encontrada (que não é incluída no valor de retorno), ou em EOF (o que ocorrer primeiro).

Esta função é praticamente idêntica a fgets() exceto por permitir delimitadores de final de linha diferente dos padrões \n, \r e \r\n, e não retorna o delimitador em si.

Parâmetros

stream

Um manipulador de arquivo válido.

length

O número máximo de bytes para leitura do manuipulador. Valores negativos não são suportados. Zero (0) define o tamanho padrão do pacote do socket, isto é, 8192 bytes.

ending

Um delimitador string opcional.

Valor Retornado

Retorna uma string com no máximo o número de bytes de length lidos do arquivo apontado por stream, ou false em caso de falha.

Veja Também