array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'streamwrapper.stream-read.php', 1 => 'streamWrapper::stream_read', 2 => 'Lit dans le flux', ), 'up' => array ( 0 => 'class.streamwrapper.php', 1 => 'streamWrapper', ), 'prev' => array ( 0 => 'streamwrapper.stream-open.php', 1 => 'streamWrapper::stream_open', ), 'next' => array ( 0 => 'streamwrapper.stream-seek.php', 1 => 'streamWrapper::stream_seek', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/stream/streamwrapper/stream-read.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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ée. 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ée directement après streamWrapper::stream_read() pour vérifier si EOF a été atteint. Si la fonction n'est pas implémentée, 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