9.1.4.4 php_stream_read()Lit des octets depuis un flôt dans un buffer[ Exemples avec hp_stream_read ] CVS uniquement
size_t
php_stream_read (
php_stream *
stream
,
char *
buf
,
size_t
count
)
php_stream_read
lit jusqu'à
count
octets dans le flôt
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 flôt 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 flôt (bloquant, non bloquant). Par défaut, un flôt est
ouvert en mode bloquant. Lorsque vous lisez dans des fichiers classiques, le mode bloquant
ne vous gènera pas. Lors que le flôt atteint
EOF
php_stream_read
retournera un nombre d'octets lus inférieur
à
count
, puis il retournera 0 aux prochaines lectures.
|