Manuel PHP
Précédent |  | Suivant

# 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 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. 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.exemple.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.

Précédent | Sommaire | Suivant
stream_filter_remove | Niveau supérieur | stream_get_filters