array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'streamwrapper.stream-read.php', 1 => 'streamWrapper::stream_read', 2 => 'Lee desde el flujo', ), 'up' => array ( 0 => 'class.streamwrapper.php', 1 => 'streamWrapper', ), 'prev' => array ( 0 => 'streamwrapper.stream-open.php', 1 => 'streamWrapper::stream_open', ), 'next' => array ( 0 => 'streamwrapper.stream-seek.php', 1 => 'streamWrapper::stream_seek', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/stream/streamwrapper/stream-read.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

streamWrapper::stream_read

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::stream_read — Lee desde el flujo

Descripción

public streamWrapper::stream_read(int $count): string|false

Este método es llamado en respuesta a fread() y fgets().

Nota:

No olvide modificar la posición de lectura y escritura del número de bytes que han podido ser leídos.

Parámetros

count

El número de bytes que han podido ser leídos, a partir de la posición actual.

Valores devueltos

Si hay menos que count bytes disponibles, tantos como sea posible deberían ser retornados. Si no hay más datos disponibles, un string vacío debe ser retornado. Para señalar un error de lectura false debe ser retornado.

Errores/Excepciones

Emite una advertencia E_WARNING si la llamada a este método falla (i.e. no implementado).

Nota:

Si el valor de retorno es mayor que count, se emitirá una advertencia E_WARNING, y los datos excedentes se perderán.

Notas

Nota:

streamWrapper::stream_eof() es llamado directamente después de streamWrapper::stream_read() para verificar si se ha alcanzado EOF. Si la función no está implementada, se utilizará EOF.

Advertencia

Al leer completamente un fichero (por ejemplo, mediante la función file_get_contents()), PHP llamará a la función streamWrapper::stream_read() seguida de la función streamWrapper::stream_eof() en un bucle, pero mientras la función streamWrapper::stream_read() retorne un string no vacío, el valor retornado de la función streamWrapper::stream_eof() será ignorado.

Ver también