(no version information, might be only in CVS)
php_stream_read -- Leer un número de bytes desde una secuencia a
un búfer
Descripción
size_t
php_stream_read ( php_stream * secuencia, char * buf, size_t conteo )
php_stream_read() lee
hasta conteo bytes de datos
desde secuencia y los copia en el
búfer buf.
php_stream_read() devuelve el número de
bytes que fueron leÃdos satisfactoriamente. No hay
distinción entre una lectura fallida o una
condición de final-de-archivo -
use php_stream_eof() para revisar si se
encuentra en EOF.
La posición interna de la secuencia es desplazada hacia
adelante por el número de bytes que fueron leÃdos,
de modo que las lecturas subsiguientes continuarán desde
ese punto.
Si hay menos de conteo bytes disponibles
para su lectura, ésta llamada creará un bloqueo
(esperará) hasta que el número requerido se
encuentre disponible, dependiendo del status de bloqueo de la
secuencia. Por defecto, una secuencia es abierta en modo de
bloqueo. Cuando se lee desde archivos regulares, el modo de
bloqueo usualmente no representará ninguna diferencia:
cuando la secuencia alcance
el EOF, php_stream_read()
devolverá un valor menor
que conteo, y 0 en cualquier lectura
subsiguiente.
