Lee desde el flujo

# streamWrapper::stream_read

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

streamWrapper::stream_read — Lee desde el flujo

### Descripción

public function streamWrapper::stream_read(int `$count`): string|false

Este método es llamado en respuesta a fread() y fgets().

> Nota:

> No olvide modificar la posición de lectura y escritura del número de bytes que han podido ser leídos.

### Parámetros

`count`

  El número de bytes que han podido ser leídos, a partir de la posición actual.

### Valores devueltos

Si hay menos que `count` bytes disponibles, tantos como sea posible deberían ser retornados. Si no hay más datos disponibles, un string vacío debe ser retornado. Para señalar un error de lectura `false` debe ser retornado.

### Errores/Excepciones

Emite una advertencia `E_WARNING` si la llamada a este método falla (i.e. no implementado).

> Nota:

> Si el valor de retorno es mayor que `count`, se emitirá una advertencia `E_WARNING`, y los datos excedentes se perderán.

### Notas

> Nota:

> streamWrapper::stream_eof() es llamado directamente después de streamWrapper::stream_read() para verificar si se ha alcanzado EOF. Si la función no está implementada, se utilizará EOF.

Advertencia

Al leer completamente un fichero (por ejemplo, mediante la función file_get_contents()), PHP llamará a la función streamWrapper::stream_read() seguida de la función streamWrapper::stream_eof() en un bucle, pero mientras la función streamWrapper::stream_read() retorne un string no vacío, el valor retornado de la función streamWrapper::stream_eof() será ignorado.

### Ver también

- fread() - Lectura del archivo en modo binario
- fgets() - Recupera la línea actual a partir de la posición del puntero de archivo

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open