PHP 8.4.0 RC4 available for testing

eio_sync_file_range

(PECL eio >= 0.0.1dev)

eio_sync_file_rangeSynchronise un segment de fichier avec le disque

Description

eio_sync_file_range(
    mixed $fd,
    int $offset,
    int $nbytes,
    int $flags,
    int $pri = EIO_PRI_DEFAULT,
    callable $callback = NULL,
    mixed $data = NULL
): resource

eio_sync_file_range() permet un contrôle fin lors de la synchronisation d'un fichier ouvert spécifié par le descripteur de fichier fd avec le disque.

Liste de paramètres

fd

Le descripteur de fichier.

offset

La position de début d'intervalle à partir de laquelle la synchronisation doit s'effectuer.

nbytes

Spécifie la longueur de l'intervalle à synchroniser, en octets. Si nbytes vaut zéro, alors tous les octets depuis la position offset jusqu'à la fin du fichier seront synchronisés.

flags

Un masque. Peut inclure n'importe quelle valeur suivante : EIO_SYNC_FILE_RANGE_WAIT_BEFORE, EIO_SYNC_FILE_RANGE_WRITE, EIO_SYNC_FILE_RANGE_WAIT_AFTER. Ces drapeaux ont la même signification que leurs équivalents SYNC_FILE_RANGE_* (voir la page du manuel sur SYNC_FILE_RANGE(2)).

pri

La priorité de la requête : EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, ou null. Si null est passé, le paramètre pri, en interne, est défini à EIO_PRI_DEFAULT.

callback

La fonction de rappel callback est appelée lorsque la requête est terminée. Elle doit correspondre au prototype suivant :

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

représente les données personnalisées passées à la requête.

result

représente la valeur résultante spécifique à la requête ; basiquement, la valeur retournée par l'appel système correspondant.

req

est la ressource optionnelle de la requête qui peut être utilisée avec les fonctions comme eio_get_last_error().

data

Variables arbitraires à passer à la fonction de rappel callback.

Valeurs de retour

eio_sync_file_range() retourne la ressource demandée, en cas de succès, ou false si une erreur survient.

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top