Win32::ChangeNotify - Surveillance d'événements relatifs à des fichiers et répertoires


NOM

Win32::ChangeNotify - Surveillance d'événements relatifs à des fichiers et répertoires

Retour en haut de la page


SYNOPSIS

        require Win32::ChangeNotify;
        $notify = Win32::ChangeNotify->new($Path,$WatchSubTree,$Events);
        $notify->wait or warn "Something failed: $!\n";
        # Il y a eu un changement.

Retour en haut de la page


DESCRIPTION

Ce module permet au programmeur d'utiliser un objet «notification de modification Win32» depuis Perl. Cela permet aux programmes Perl de surveiller des événements concernant les fichiers et les arborescences de répertoires.

La méthode wait et les fonctions wait_all et wait_any sont héritées du module Win32::IPC.

Méthodes

$notify = Win32::ChangeNotify->new($path, $subtree, $filter)
Constructeur d'un nouvel objet ChangeNotification. $path est le répertoire à surveiller. Si $subtree est vrai, alors tous les sous-répertoires de $path seront surveillés. $filter indique quels événements doivent déclencher la notification. Ce doit être une chaîne contenant n'importe lequel des drapeaux suivants (séparés par des espaces et/ou |).
   ATTRIBUTES   un attribut a changé
   DIR_NAME     un nom de répertoire a changé
   FILE_NAME    un nom de fichier a changé (création/effacement/renommage)
   LAST_WRITE   la date de dernière écriture d'un fichier a changé
   SECURITY     un descripteur de sécurité a changé
   SIZE         la taille d'un fichier a changé

($filter peut aussi être un entier composé avec les constantes de FILE_NOTIFY_CHANGE_*.)

$notify->close
Arrête la surveillance. À la place, vous pouvez juste faire undef $notify (mais close fonctionne même s'il y a d'autres copies de l'objet). Cette fonction est appelée automatiquement quand votre programme se termine.

$notify->reset
Réinitialise l'objet ChangeNotification après qu'un changement ait été détecté. L'objet sera encore déclenché au prochain changement. (C'est OK pour l'appeler immédiatement après un new, mais ce n'est pas obligatoire.)

$notify->wait
Voir Win32::IPC. N'oubliez pas d'appeler ensuite reset si vous voulez continuer la surveillance.

Fonctions et méthodes dépréciées

Win32::ChangeNotify accepte encore la syntaxe ActiveWare, mais son utilisation est déconseillée.

FindFirst($Obj,$PathName,$WatchSubTree,$Filter)
Utilisez
  $Obj = Win32::ChangeNotify->new($PathName,$WatchSubTree,$Filter)

à la place.

$obj->FindNext()
Use $obj->reset instead.

$obj->Close()
Utilisez $obj->close à la place.

Retour en haut de la page


AUTEUR

Christopher J. Madsen <chris_madsen@geocities.com>

Vaguement basé sur le module original d'ActiveWare Internet Corp., http://www.ActiveWare.com

Retour en haut de la page


VERSION FRANÇAISE

Cette traduction française correspond à la version anglaise distribuée avec perl 5.6.1. Pour en savoir plus concernant ces traductions, consultez http://www.enstimac.fr/Perl/ .

Retour en haut de la page


TRADUCTION EN FRANÇAIS

Jean-Louis Morel <jl_morel@bribes.org>

Retour en haut de la page

 Win32::ChangeNotify - Surveillance d'événements relatifs à des fichiers et répertoires