stream_filter_remove
stream_get_filters
Fonctions sur les flux
PHP Manual

# stream_get_contents

(PHP 5)

stream_get_contents — Lit 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

stream_filter_remove
stream_get_filters
Fonctions sur les flux
PHP Manual