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 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

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