# streamWrapper::stream_read

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

streamWrapper::stream_read — Leer 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