stream_get_contents

(PHP 5)

stream_get_contentsLit tout un flux dans une chaîne

Description

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

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

Liste de paramètres

handle (resource)

Une ressource de flux (e.g. retournée 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. Si le nombre passé est négatif, aucun déplacement ne sera effectué et la lecture commencera de la position courante.

Valeurs de retour

Retourne une chaîne de caractères ou FALSE si une erreur survient.

Historique

Version Description
5.1.0 Le paramètre offset a été ajouté.

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.exemple.net', 'r')) {
	// Affichage des 5 premiers octets
	echo stream_get_contents($stream, 5);

	fclose($stream);
}

?>

Notes

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

Voir aussi

  • fgets() - Récupère la ligne courante sur laquelle se trouve le pointeur du fichier
  • fread() - Lecture du fichier en mode binaire
  • fpassthru() - Affiche le reste du fichier

LoadingChargement en cours