streamWrapper::stream_read

(PHP 4 >= 4.3.2, PHP 5, PHP 7)

streamWrapper::stream_readLeer un flujo

Descripción

public streamWrapper::stream_read ( int $count ) : string

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 count se emitirá un error de nivel E_WARNING y 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.

Advertencia

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.

Ver también

  • fread() - Lectura de un fichero en modo binario seguro
  • fgets() - Obtiene una línea desde el puntero a un fichero