php_stream_read

(no version information, might be only in CVS)

php_stream_read -- Lit des octets depuis un flux dans un buffer

Description

size_t php_stream_read ( php_stream * stream, char * buf, size_t count )

php_stream_read() lit jusqu'à count octets dans le flux stream puis les copie dans le buffer buf.

php_stream_read() retourne le nombre d'octets lus. Il n'y a pas de disctinction entre une lecture qui échoue et la fin du fichier : utilisez php_stream_eof() pour tester la fin du fichier avec EOF.

Le pointeur de position dans le flux est avancé d'autant d'octets que le nombre qui en a été lu. Par conséquent, la prochaine lecture reprendra là ou la lecture précédente s'est arrêtée.

Si moins de count octets ont été lus, cet appel bloquera l'application jusqu'à ce que le nombre d'octets nécessaire soit atteint, en fonction de la configuration du flux (bloquant, non bloquant). Par défaut, un flux est ouvert en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant ne vous gènera pas. Lors que le flux atteint EOF php_stream_read() retournera un nombre d'octets lus inférieur à count, puis il retournera 0 aux prochaines lectures.