eio_rename
(PECL eio >= 0.0.1dev)
eio_rename — Modifie le nom ou le chemin d'un fichier
Description
string
$path,string
$new_path,int
$pri = EIO_PRI_DEFAULT,callable
$callback = NULL,mixed
$data = NULL): resource
eio_rename() renomme ou déplace un fichier vers un nouvel endroit.
Liste de paramètres
-
path -
Chemin source
-
new_path -
Chemin cible
-
pri -
La priorité de la requête :
EIO_PRI_DEFAULT,EIO_PRI_MIN,EIO_PRI_MAX, ounull. Sinullest passé, le paramètrepri, en interne, est défini àEIO_PRI_DEFAULT. -
callback -
La fonction de rappel
callbackest 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_rename() retourne la ressource demandée en cas
de succès, ou false si une erreur survient.
Exemples
Exemple #1 Exemple avec eio_rename()
<?php
$filename = dirname(__FILE__)."/eio-temp-file.dat";
touch($filename);
$new_filename = dirname(__FILE__)."/eio-temp-file-new.dat";
function my_rename_cb($data, $result) {
global $filename, $new_filename;
if ($result == 0 && !file_exists($filename) && file_exists($new_filename)) {
@unlink($new_filename);
echo "eio_rename_ok";
} else {
@unlink($filename);
}
}
eio_rename($filename, $new_filename, EIO_PRI_DEFAULT, "my_rename_cb", $filename);
eio_event_loop();
?>Résultat de l'exemple ci-dessus est similaire à :
eio_rename_ok
add a note
