# stream_get_line

(PHP 5, PHP 7, PHP 8)

stream_get_line — Lit une ligne dans un flux

### Description

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

stream_get_line() lit une ligne dans la ressource `handle`.

La lecture se termine quand `length` octets ont été lus, quand la chaîne non-vide spécifiée par `ending` a été rencontrée (mais ne sera pas inclue dans la valeur retournée), ou si EOF survient : n'importe lequel des trois qui survient en premier.

Cette fonction est presque identique à fgets() hormis le fait qu'elle permet d'utiliser un délimiteur de ligne différent des caractères standards de `\n`, `\r` et `\r\n`, et ne retourne pas le délimiteur lui-même.

### Liste de paramètres

`stream`

  Une resource valide de fichier.

`length`

  Le nombre maximum d'octets à lire depuis le gestionnaire. Les valeurs négatives ne sont pas supportées. Zéro (`0`) signifie la taille de chunk de socket par défaut, i.e. `8192` octets.

`ending`

  Un délimiteur de chaîne optionnel.

### Valeurs de retour

stream_get_line() lit une ligne de taille maximale `length` dans le flux `stream` ou `false` si une erreur survient.

### Voir aussi

- fread() - Lecture du fichier en mode binaire
- fgets() - Récupère la ligne courante à partir de l'emplacement du pointeur sur fichier
- fgetc() - Lit un caractère dans un fichier