# streamWrapper::stream_read

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::stream_read — Lit dans le flux

### Description

public streamWrapper::stream_read(int `$count`): string|false

Cette méthode est appelée en réponse à fread() et fgets().

> Note:

> N'oubliez pas de modifier la position de lecture et écriture du nombre d'octets qui ont pu être lus.

### Liste de paramètres

`count`

  Le nombre d'octets qui ont pu être lus, à partir de la position courante.

### Valeurs de retour

S'il y a moins que `count` octets disponibles, autant que possible devrait être retourné. S'il n'y a plus de données disponibles, une chaîne vide doit être retourné. Pour signaler une erreur de lecture `false` doit être retourné.

### Erreurs / Exceptions

Émet une alerte `E_WARNING` si l'appel à cette méthode échoue (i.e. pas implémenté).

> Note:

> Si la valeur de retour est plus grande que `count`, une erreur `E_WARNING` sera émise, et les données excédentaires seront perdues.

### Notes

> Note:

> streamWrapper::stream_eof() est appelé directement après streamWrapper::stream_read() pour vérifier si EOF a été atteint. Si la fonction n'est pas implémenté, EOF est utilisé.

Avertissement

Lors de la lecture complète d'un fichier (par exemple, par la fonction file_get_contents()), PHP appellera la fonction streamWrapper::stream_read() suivie de la fonction streamWrapper::stream_eof() dans une boucle, mais tant que la fonction streamWrapper::stream_read() retournera une chaîne non vide, la valeur retournée de la fonction streamWrapper::stream_eof() sera ignorée.

### Voir aussi

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