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
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
- fread() - Leitura de arquivo segura para binário
- fgets() - Lê uma linha de um ponteiro de arquivo
- fgetc() - Lê um caractere do ponteiro de arquivo