stream_get_contents
En esta página
stream_get_contents
Lee todo un flujo en un string
Descripción#
stream_get_contents(resource $stream, [int $length], [int $offset]): string
```php
`stream_get_contents` es idéntica a `file_get_contents`, salvo que opera sobre un puntero de fichero ya abierto y devuelve el contenido restante, hasta `length` bytes, en un string y comenzando en la posición `offset`.
## Parámetros
`stream` (`resource`)
Un `resource` de flujo (por ejemplo, devuelto por la función `fopen`)
`length` (`int`)
El número máximo de bytes a leer. Por omisión, `null` (lee todo el contenido restante del buffer).
`offset` (`int`)
Se desplaza a la posición especificada antes de la lectura. Si el número pasado es negativo, no se realizará ningún desplazamiento y la lectura comenzará desde la posición actual.
## Valores devueltos
Devuelve un `string` o `false` si ocurre un error.
## Historial de cambios
| Versión | Descripción |
|---------|-----------------------------|
| 8.0.0 | `length` ahora es nullable. |
## Ejemplos
Ejemplo con `stream_get_contents`
```php
Notas#
[!NOTE] Esta función es segura para sistemas binarios.
[!NOTE] Cuando se especifica un valor de
lengthdistinto denull, esta función asignará inmediatamente un buffer interno de ese tamaño, incluso si el contenido real es significativamente más corto.
Véase también#
fgets, fread, fpassthru