stream_get_contents
(PHP 5, PHP 7, PHP 8)
stream_get_contents — Reads remainder of a stream into a string
Descrição
stream_get_contents(resource $stream
, ?int $length
= null
, int $offset
= -1): string|false
Parâmetros
-
stream
(resource)
-
A stream resource (e.g. returned from fopen())
-
length
(int)
-
The maximum bytes to read. Defaults to null
(read all the remaining
buffer).
-
offset
(int)
-
Seek to the specified offset before reading. If this number is negative,
no seeking will occur and reading will start from the current position.
Valor Retornado
Returns a string ou false
em caso de falha.
Exemplos
Exemplo #1 stream_get_contents() example
<?php
if ($stream = fopen('http://www.example.com', 'r')) {
// print all the page starting at the offset 10
echo stream_get_contents($stream, -1, 10);
fclose($stream);
}
if ($stream = fopen('http://www.example.net', 'r')) {
// print the first 5 bytes
echo stream_get_contents($stream, 5);
fclose($stream);
}
?>
Notas
Nota: Esta função é
compatível com dados binários.
Nota:
When specifying a length
value other than null
, this function will
immediately allocate an internal buffer of that size even if the
actual contents are significantly shorter.
Veja Também
- fgets() - Lê uma linha de um ponteiro de arquivo
- fread() - Binary-safe file read
- fpassthru() - Imprime todo os dados restantes de um ponteiro de arquivo