# stream_get_line

(PHP 5, PHP 7, PHP 8)

stream_get_line — Obtiene una línea del recurso de flujo hasta un delimitador dado

### Descripción

stream_get_line(resource `$handle`, int `$length`, string `$ending` = ?): string

Obtiene una linea desde el gestor dado.

La lectura finaliza cuando hayan sido leídos `length` bytes, cuando se encuentre la cadena especificada por `ending` (la cuál no está incluida en el valor devuelto), o sobre EOF (lo que suceda primero).

Esta función es casi indéntica a fgets() excepto que permite delimitadores de fin de línea distintos a los habituales \n, \r, y \r\n, y no devuelve el delimitador mismo.

### Parámetros

`handle`

  Un gestor de archivo válido.

`length`

  El número de bytes a leer desde el gestor.

`ending`

  Un delimitador de cadena opcional.

### Valores devueltos

Devuelve una cadena de hasta `length` bytes leídos desde el archivo apuntado por `handle`.

Si ocurre un error, devuelve `false`.

### Ver también

- fread() - Lectura de un fichero en modo binario seguro
- fgets() - Obtiene una línea desde el puntero a un fichero
- fgetc() - Obtiene un carácter de un puntero a un archivo