streamWrapper::stream_read
(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::stream_read — Leer un flujo
Descripción
$count
)Este método es llamado en respuesta a fread() y fgets().
Nota:
Recuerde actualizar la posición de lectura/escritura del flujo (por el número de bytes que fueron leídos con éxito).
Parámetros
-
count -
Cuántos bytes de información desde la posición actual deberían ser devueltos.
Valores devueltos
Si hay menos bytes disponibles que en count
devolver tantos como estén disponibles. Si no hay
más información disponible, devolver FALSE o una
cadena vacía.
Errores/Excepciones
Emite un
E_WARNING si la llamada a este método falla
(por ej., por no estar implementado).
Nota:
Si el valor devuelto es mayor que
countse emitirá un error de nivelE_WARNINGy la información en exceso se perderá.
Notas
Nota:
streamWrapper::stream_eof() es llamado directamente después de llamar a streamWrapper::stream_read() para verificar si EOF ha sido alcanzado. Si no está implementado, se asume EOF.
Al leer un fichero entero (por ejemplo, con file_get_contents()), PHP llamará a streamWrapper::stream_read() seguido de streamWrapper::stream_eof() en un bucle, pero siempre y cuando streamWrapper::stream_read() devuelva un texto no vacío, el valor que devuelva streamWrapper::stream_eof() será ignorado.