eio_fallocate

(PECL eio >= 0.0.1dev)

eio_fallocate — Permite ao chamador manipular diretamente o espaço alocado em disco para um arquivo

Descrição

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

eio_fallocate() permite ao chamador manipular diretamente o espaço alocado em disco para o arquivo especificado elo descrito de arquivo fd para o intervalo de byte iniciando em offset e continuando pelo númer de bytes informado em length.

Nota: O arquivo deve ser aberto para escrita
EIO_O_CREAT deve ser combinado através de uma operação lógica OR com EIO_O_WRONLY ou EIO_O_RDWR

Parâmetros

fd

Fluxo, recurso de socket ou descritor numérico de arquivo, por exemplo, retornado por eio_open().

mode

Atualmente apenas uma opção de modo é suportada: EIO_FALLOC_FL_KEEP_SIZE (o mesmo que a constante POSIX FALLOC_FL_KEEP_SIZE).

offset

Especifica o início do intervalo de bytes.

length

Especifica o comprimento do intervalo de bytes.

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_fallocate() retorna o recurso da requisição em caso de sucesso, ou false em caso de falha.