Transfiere el resto de un flujo a una cadena

Descripción

stream_get_contents ( resource $handle [, int $maxlength = -1 [, int $offset = -1 ]] ) : string

Idéntica a file_get_contents(), excepto que stream_get_contents() opera sobre un recurso de flujo ya abierto y devuelve el resto del contenido en una cadena, hasta maxlength bytes y comenzando por el offset especificado.

Parámetros

handle (resource): Un recurso de flujo (p.ej. devuelto desde fopen())
maxlength (integer): El máximo de bytes a leer. Por defecto es -1 (lee todo el buffer restante).
offset (integer): Busca el índice especificado antes de leer. Si este número es negativo, no se hará ninguna búsqueda y la lectura comenzará desde la posición actual.

Valores devueltos

Devuelve una cadena o FALSE en caso de error.

Historial de cambios

Versión	Descripción
5.1.0	Se añadió el parámetro `offset`.

Ejemplos

Ejemplo #1 Ejemplo de stream_get_contents()


<?php

if ($stream = fopen('http://www.example.com', 'r')) {
    // imprimir toda la página empezando por el índice 10
    echo stream_get_contents($stream, -1, 10);

    fclose($stream);
}


if ($stream = fopen('http://www.example.net', 'r')) {
    // imprimir los 5 primeros bytes
    echo stream_get_contents($stream, 5);

    fclose($stream);
}

?>

Notas

Nota: Esta función es segura binariamente.

Ver también

fgets() - Obtiene una línea desde el puntero a un fichero
fread() - Lectura de un fichero en modo binario seguro
fpassthru() - Escribe toda la información restante de un puntero a un archivo