stream_get_contents

(PHP 5)

stream_get_contents -- Lit le reste d'un flux dans une chaîne

Description

string stream_get_contents ( resource handle [, int maxlength [, int offset]] )

Identique à file_get_contents(), sauf que stream_get_contents() opère sur un pointeur de fichier déjà ouvert et retourne le contenu restant, allant jusqu'à maxlength octets, dans une chaîne et commançant à la position offset.

Liste de paramètres

handle (resource)

Une ressource de flux (e.g. retourné par la fonction fopen())

maxlength (entier)

Le nombre maximal d'octets à lire. Par défaut, -1 (lit tout le contenu restant du buffer).

offset (entier)

Se déplace à la position spécifiée avant la lecture. Ajouté en PHP 5.1.0.

Valeurs de retour

Retourne une chaîne de caractères ou FALSE en cas d'échec.

Exemples

Exemple 1. Exemple avec stream_get_contents()

<?php

if ($stream = fopen('http://www.example.com', 'r')) {
    
// affiche toute la page, en commençant à la position 10
    
echo stream_get_contents($stream, -1, 10);

    
fclose($stream);
}


if (
$stream = fopen('http://www.example.net', 'r')) {
    
// Affichage des 5 premiers octets
    
echo stream_get_contents($stream, 5);

    
fclose($stream);
}

?>

Voir aussi

fgets()
fread()
fpassthru()

Note : Cette fonction gère les chaînes binaires