(PECL eio >= 0.0.1dev)
eio_read — Leer de un descriptor de fichero en un índice dado
$fd,$length,$offset,$pri,$callback,$data = NULL
eio_read() lee hasta length
bytes desde el descriptor de fichero fd empezando en
offset. Los bytes leídos son almacenados en el
argumento result de callback.
fdUn flujo, un recurso Socket, o un descriptor numérico de fichero.
lengthEl número máximo de bytes a leer.
offsetEl índice dentro del fichero.
priLa prioridad de la petición: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, o null.
Si null es pasado, el parámetro pri, internamente, es definido a
EIO_PRI_DEFAULT.
callback
La función de retrollamada callback
es llamada cuando la petición está terminada.
Debe corresponder al siguiente prototipo:
void callback(mixed $data, int $result[, resource $req]);datarepresenta los datos personalizados pasados a la petición.
resultrepresenta el valor resultante específico de la petición; básicamente, el valor retornado por la llamada al sistema correspondiente.
reqes el recurso opcional de la petición que puede ser utilizado con funciones como eio_get_last_error().
data
Variable arbitraria pasada a callback.
eio_read() almacena los bytes leídos en el
argumento result de la función
callback.
Ejemplo #1 Ejemplo de eio_read()
<?php
// Abrir un fichero temporal y escribir algunos bytes en él
$nombre_fichero_temp = "eio-temp-file.tmp";
$fp = fopen($nombre_fichero_temp, "w");
fwrite($fp, "1234567890");
fclose($fp);
/* Es llamada cuando eio_read() termina */
function mi_llamada_retorno_read($datos, $resultado) {
global $nombre_fichero_temp;
// Imprimir los bytes leídos
var_dump($resultado);
// Cerrar el fichero
eio_close($datos);
eio_event_loop();
// Eliminar el fichero temporal
@unlink($nombre_fichero_temp);
}
/* Es llamada cuanco eio_open() termina */
function mi_llamada_retorno_fichero abierto($datos, $resultado) {
// $resultado debería contener el descriptor del fichero
if ($resultado > 0) {
// Leer 5 bytes empezando desde el tercero
eio_read($resultado, 5, 2, EIO_PRI_DEFAULT, "mi_llamada_retorno_read", $resultado);
eio_event_loop();
} else {
// eio_open() falló
unlink($datos);
}
}
// Abrir el fichero para leer y escribir
eio_open($nombre_fichero_temp, EIO_O_RDWR, NULL,
EIO_PRI_DEFAULT, "mi_llamada_retorno_fichero abierto", $nombre_fichero_temp);
eio_event_loop();
?>Resultado del ejemplo anterior es similar a:
string(5) "34567"