array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.eio-read.php', 1 => 'eio_read', 2 => 'Lê um descritor de arquivo em determinada posição', ), 'up' => array ( 0 => 'ref.eio.php', 1 => 'Funções de Eio', ), 'prev' => array ( 0 => 'function.eio-poll.php', 1 => 'eio_poll', ), 'next' => array ( 0 => 'function.eio-readahead.php', 1 => 'eio_readahead', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/eio/functions/eio-read.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

eio_read

(PECL eio >= 0.0.1dev)

eio_read — Lê um descritor de arquivo em determinada posição

Descrição

eio_read(
    mixed $fd,
    int $length,
    int $offset,
    int $pri,
    callable $callback,
    mixed $data = NULL
): resource

eio_read() lê até length bytes do descrito de arquivo fd na posição offset. Os bytes lidos são armazenados no argumento result de callback.

Parâmetros

fd
Fluxo, recurso de socket ou descritor numérico de arquivo.
length
Número máximo de bytes para leitura.
offset
Posição no arquivo.
pri

A prioridade da requisição: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX ou null. Se null for passado, o parâmetro pri internamente será definido como EIO_PRI_DEFAULT.

callback

A função callback é chamada quando a requisição é concluída. Ela deve corresponder ao seguinte protótipo:

void callback(mixed $data, int $result[, resource $req]);
data

são dados personalizados passados para a requisição.

result

valor de resultado específico da requisição; basicamente, o valor retornado pela chamada de sistema correspondente.

req

é um recurso de requisição opcional que pode ser usado com funções como eio_get_last_error().

data
Variável arbitrária passada para callback.

Valor Retornado

eio_read() armazena os bytes lidos no argumento result da funcão callback.

Exemplos

Exemplo #1 Exemplo de eio_read()

<?php
// Abre um arquivo temporário e escreva alguns bytes nele
$temp_filename = "eio-temp-file.tmp";
$fp = fopen($temp_filename, "w");
fwrite($fp, "1234567890");
fclose($fp);

/* Função chamada quando eio_read() termina */
function my_read_cb($data, $result) {
global $temp_filename;

// Mostra os bytes lidos
var_dump($result);

// Fecha o arquivo
eio_close($data);
eio_event_loop();

// Remove o arquivo temporário
@unlink($temp_filename);
}

/* Função chamada quando eio_open() termina */
function my_file_opened_callback($data, $result) {
// $result deve conter o descritor de arquivo
if ($result > 0) {
// Lê 5 bytes iniciando do terceiro
eio_read($result, 5, 2, EIO_PRI_DEFAULT, "my_read_cb", $result);
eio_event_loop();
} else {
// eio_open() falhou
unlink($data);
}
}

// Abre o arquivo para leitura e gravação
eio_open($temp_filename, EIO_O_RDWR, NULL,
EIO_PRI_DEFAULT, "my_file_opened_callback", $temp_filename);
eio_event_loop();
?>

O exemplo acima produzirá algo semelhante a:

string(5) "34567"

Veja Também