php_stream_read

Descripción

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.