streamWrapper::stream_read
(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::stream_read — Lit dans le flux
Description
$count
)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, il faut en retourner autant que possible. S'il
n'y a plus de données disponibles, il faut retourner
FALSE
ou une chaîne vide.
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 erreurE_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é.
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.