-
-
Notifications
You must be signed in to change notification settings - Fork 18
fr:Documentation ARexxAPI
À l'aide de scripts ARexx vous pouvez ajouter de nouvelles fonctions à YAM ou bien lui laissé effectuer des fonctions automatiquement. YAM offre un ensemble de commandes (listées #FixListByName et #FixListByFunction), qui peuvent être appelées à travers le port ARexx « YAM ». Il y aura des explications tout au long des sous-chapitres en utilisant le format suivant :
NOM:: Le nom de la commande, une courte description de ce qu'elle fait et la version de YAM depuis laquelle elle est implémentée.
SYNTAXE:: Les arguments et options acceptés par la commande. La syntaxe utilise des caractères spéciaux pour indiquer le type particulier de l'argument attendu, en suivant le style de l'AmigaOS :
`/A` Le paramètre est facultatif\\
`/K` Le paramètre doit être précédé du mot clé\\
`/N` Argument ou résultat numérique\\
`/M` L'argument ou le résultat est une liste composée (de zéro à plus) éléments\\
`/S` Le paramètre fonctionne comme un interrupteur ; il est activé quand il est mentionné.\\
FONCTION:: Donne une description de la commande.
ENTREE:: Décrit en détail les paramètres acceptés par la commande. Prenez garde lorsque vous passez des arguments contenant des espaces. Par exemple :
{{{#!arexx
sub = 'Hello World'
'WRITESUBJECT' sub
}}}
ne fonctionnera pas. Il aurait fallu écrire :
{{{#!arexx
'WRITESUBJECT "'sub'"'
}}}
ou
{{{#!arexx
'WRITESUBJECT "Hello World"'
}}}
Veuillez noter qu'à cause de l'utilisation en interne de la fonction
ReadArgs(), l'hôte ARexx nécessite l'échappement de certains caractères
spéciaux comme un retour à la ligne (0x0a) ou le caractère d'échappement
(0x1b) si vous voulez qu'il soit inclus dans votre chaine finale, dans le
cas contraire, il sera éliminé par la fonction ReadArgs().
Cela signifie que vous devez utiliser les séquences d'échappement
suivantes dans vos chaines de caractères :
`*N` remplace 0x0a\\
`*E` remplace 0x1b\\
`**` remplace *\\
`*"` remplace "\\
Par exemple la commande suivante écrit un chaine de caractère contenant
un retour à la ligne dans l'éditeur :
{{{#!arexx
'WRITEEDITOR "TEXT Bonjour Joe,*N je voudrais vous rencontrer."'
}}}
Si un paramètre représente un nom de fichier, vous devez garder à l'esprit que les noms de fichier sous AmigaOS peuvent contenir des espacements ou autres caractères spéciaux qui ferant qu'ARexx traitera le nom comme plusieurs mots au lieu d'un seul mot. De ce fait, un nom de fichier devrait *toujours* être entouré de guillemets ("), qu'importe qu'il contient des espaces ou pas. Les scripts peuvent facilement être testés pour ce cas en procurant un fichier du disque RAM; par exemple "RAM Disk:/foo/bar".
RESULTAT:: Retourne un résultat attendu. Les commandes peuvent retourner un résultat de trois manières différentes. Jetez un oeil aux exemples qui utilisent la commande FOLDERINFO :
{{{#!arexx
FOLDERINFO
-> RESULT = "0 Reçus incoming 10 2 4 23030 1"
}}}
{{{#!arexx
FOLDERINFO VAR fi
-> fi = "0 Reçus incoming 10 2 4 23030 1"
}}}
{{{#!arexx
FOLDERINFO STEM fi.
-> fi.number = 0
fi.name = "Reçus"
fi.path = "incoming"
fi.total = 10
fi.new = 2
fi.unread = 4
fi.size = 23030
fi.type = 1
}}}
Un autre exemple qui retourne un résultat de type `/M` :
{{{#!arexx
ADDRFIND STEM found. "Marcel Beck" NAMEONLY
-> found.alias.count = 2
found.alias.0 = "Mars"
found.alias.1 = "mbe"
}}}
ATTENTION:: Toutes sortes d'informations auxquelles il faut prêter attention en utilisant cette commande.
NOTES:: Remarques variées sur la commande.
EXEMPLE:: Un bout de code ARexx pour illustrer l'utilisation de la commande.
BUGS:: Problèmes connus ou corrigés avec cette commande.
VOIR AUSSI:: Liens relatifs à d'autres commandes.
ARexxAPI/HELP - Affiche une liste de toutes les commandes ARexx supportées.\ ARexxAPI/HIDE - Icônifie YAM.\ ARexxAPI/INFO - Affiche les informations sur le programme.\ ARexxAPI/QUIT - Quitte YAM.\ ARexxAPI/SCREENTOBACK - Place l'écran de YAM en arrière plan.\ ARexxAPI/SCREENTOFRONT - Place l'écran de YAM au premier plan.\ ARexxAPI/SHOW - Désicônifie YAM.\
ARexxAPI/ADDRDELETE - Supprime une entrée du carnet d'adresses.\ ARexxAPI/ADDREDIT - Rempli les champs de l'entrée actuelle du carnet d'adresses.\ ARexxAPI/ADDRFIND - Recherche une entrée dans le carnet d'adresses.\ ARexxAPI/ADDRGOTO - Sélectionne une entrée du carnet d'adresses avec alias.\ ARexxAPI/ADDRINFO - Retourne les informations d'une entrée référencée par un alias.\ ARexxAPI/ADDRLOAD - Charge un carnet d'adresses avec son nom de fichier.\ ARexxAPI/ADDRNEW - Crée une nouvelle entrée dans le carnet d'adresses.\ ARexxAPI/ADDRRESOLVE - Retrouve un alias ou un nom.\ ARexxAPI/ADDRSAVE - Sauve le carnet d'adresses sous un nom donné.\
ARexxAPI/FLUSHINDEXES - Libérer les indexs de tous les dossiers.\ ARexxAPI/FOLDERINFO - Retourne les informations sur le dossier donné.\ ARexxAPI/GETFOLDERINFO - Retourne les informations sur le dossier en cours.\ ARexxAPI/MAILFILTER - Filtre les messages du dossier en cours.\ ARexxAPI/MAILUPDATE - Met à jour l'index du dossier en cours.\ ARexxAPI/NEWMAILFILE - Retourne la zone de message libre pour un dossier donné.\
ARexxAPI/APPBUSY - Place YAM en mode occupé.\ ARexxAPI/APPNOBUSY - Place YAM en mode disponible (non-occupé).\ ARexxAPI/LISTFREEZE - Désactive les mises à jour graphique d'une liste.\ ARexxAPI/LISTUNFREEZE - Réactive les mises à jour graphique d'une liste.\ ARexxAPI/READCLOSE - Ferme la fenêtre de lecture active.\ ARexxAPI/RESTART - Redémarre YAM\
ARexxAPI/GETSELECTED - Donne la position des messages sélectionnées dans le dossier en cours.\ ARexxAPI/LISTSELECT - Sélectionne les messages du dossier en cours.\ ARexxAPI/SETFOLDER - sélectionne le dossier en cours.\ ARexxAPI/SETMAIL - sélectionne le message en cours dans le dossier en cours par son numéro.\ ARexxAPI/SETMAILFILE - sélectionne le message en cours dans le dossier en cours par son nom de fichier.\
ARexxAPI/GETMAILINFO - Affiche les informations sur le message en cours.\ ARexxAPI/MAILARCHIVE - Déplace les messages sélectionnés vers un autre dossier.\ ARexxAPI/MAILBOUNCE - Détourne le message actuellement sélectionné.\ ARexxAPI/MAILCHANGESUBJECT - Change le sujet du/des message(s) sélectionné(s).\ ARexxAPI/MAILCOPY - Duplique le(s) message(s) sélectionné(s).\ ARexxAPI/MAILDELETE - Efface le(s) message(s) sélectionné(s).\ ARexxAPI/MAILEDIT - Édite le message sélectionné.\ ARexxAPI/MAILEXPORT - Exporte le(s) message(s) sélectionné(s) dans un fichier.\ ARexxAPI/MAILIMPORT - Importe les messages d'un fichier dans le dossier en cours.\ ARexxAPI/MAILINFO - Affiche les informations sur un message donné.\ ARexxAPI/MAILMOVE - Déplace le(s) message(s) sélectionné(s) vers un autre dossier.\ ARexxAPI/MAILREAD - Lit le message sélectionné.\ ARexxAPI/MAILREPLY - Répond au message sélectionné.\ ARexxAPI/MAILSTATUS - Change le statut de(s) message(s) sélectionné(s).\ ARexxAPI/READINFO - Obtient des informations sur les documents joints dans le message lu.\ ARexxAPI/READPRINT - Imprime un document joint.\ ARexxAPI/READSAVE - Sauvegarde un document joint.\ ARexxAPI/SETFLAG - Active l'état PERmanent ou VOLatile d'un message.\
ARexxAPI/GETURL - Télécharge un fichier à partir d'une URL de Web donnée.\ ARexxAPI/ISONLINE - Détecte quand YAM transfère des messages.\ ARexxAPI/MAILCHECK - Rapatrie les nouveaux messages.\ ARexxAPI/MAILSEND - Envoie les messages du dossier en attente.\ ARexxAPI/MAILSENDALL - Envoie tous les messages du dossier en attente.\
ARexxAPI/GETCONFIGINFO - Affiche les informations sur l'utilisateur en cours.\ ARexxAPI/REQUEST - Demande à l'utilisateur de faire un choix.\ ARexxAPI/REQUESTFILE - Demande à l'utilisateur de sélectionner un fichier.\ ARexxAPI/REQUESTFOLDER - Demande à l'utilisateur de choisir un dossier.\ ARexxAPI/REQUESTSTRING - Demande à l'utilisateur une chaîne de caractères.\ ARexxAPI/USERINFO - Affiche les informations concernant l'utilisateur actuel.\
ARexxAPI/MAILFORWARD - Retransmet le message actuellement sélectionné.\ ARexxAPI/MAILWRITE - Ouvre une nouvelle fenêtre d'édition pour composer un message.\ ARexxAPI/WRITEATTACH - Joint un fichier au nouveau message.\ ARexxAPI/WRITEBCC - Remplit l'en-tête BCC: d'un nouveau message.\ ARexxAPI/WRITECC - Remplit l'en-tête CC: d'un nouveau message.\ ARexxAPI/WRITEEDITOR - Passe une commande ARexx à l'éditeur interne.\ ARexxAPI/WRITEFROM - Remplit l'en-tête FROM: d'un nouveau message.\ ARexxAPI/WRITELETTER - Charge un fichier texte dans l'éditeur interne.\ ARexxAPI/WRITEMAILTO - Remplit l'en-tête TO: d'un nouveau message.\ ARexxAPI/WRITEOPTIONS - Active des options d'un nouveau message.\ ARexxAPI/WRITEQUEUE - Déplace un nouveau message dans le dossier Outgoing (attente).\ ARexxAPI/WRITEREPLYTO - Remplit l'en-tête REPLY-TO: d'un nouveau message.\ ARexxAPI/WRITESEND - Envoi un nouveau message.\ ARexxAPI/WRITESUBJECT - Remplit l'en-tête SUBJECT: d'un nouveau message.\ ARexxAPI/WRITETO - Remplit l'en-tête TO: d'un nouveau message.\
ARexxAPI/ADDRDELETE - Supprime une entrée du carnet d'adresses.\ ARexxAPI/ADDREDIT - Rempli les champs de l'entrée actuelle du carnet d'adresses.\ ARexxAPI/ADDRFIND - Recherche une entrée dans le carnet d'adresses.\ ARexxAPI/ADDRGOTO - Sélectionne une entrée du carnet d'adresses avec alias.\ ARexxAPI/ADDRINFO - Retourne les informations d'une entrée référencée par un alias.\ ARexxAPI/ADDRLOAD - Charge un carnet d'adresses avec son nom de fichier.\ ARexxAPI/ADDRNEW - Crée une nouvelle entrée dans le carnet d'adresses.\ ARexxAPI/ADDRRESOLVE - Retrouve un alias ou un nom.\ ARexxAPI/ADDRSAVE - Sauve le carnet d'adresses sous un nom donné.\ ARexxAPI/APPBUSY - Place YAM en mode occupé.\ ARexxAPI/APPNOBUSY - Place YAM en mode disponible (non-occupé).\ ARexxAPI/FLUSHINDEXES - Libérer les indexs de tous les dossiers.\ ARexxAPI/FOLDERINFO - Retourne les informations sur le dossier donné.\ ARexxAPI/GETCONFIGINFO - Affiche les informations sur l'utilisateur en cours.\ ARexxAPI/GETFOLDERINFO - Retourne les informations sur le dossier en cours.\ ARexxAPI/GETMAILINFO - Affiche les informations sur le message en cours.\ ARexxAPI/GETSELECTED - Donne la position des messages sélectionnées dans le dossier en cours.\ ARexxAPI/GETURL - Télécharge un fichier à partir d'une URL de Web donnée.\ ARexxAPI/HELP - Affiche une liste de toutes les commandes ARexx supportées.\ ARexxAPI/HIDE - Icônifie YAM.\ ARexxAPI/INFO - Affiche les informations sur le programme.\ ARexxAPI/ISONLINE - Détecte quand YAM transfère des messages.\ ARexxAPI/LISTFREEZE - Désactive les mises à jour graphique d'une liste.\ ARexxAPI/LISTSELECT - Sélectionne les messages du dossier en cours.\ ARexxAPI/LISTUNFREEZE - Réactive les mises à jour graphique d'une liste.\ ARexxAPI/MAILARCHIVE - Déplace les messages sélectionnés vers un autre dossier.\ ARexxAPI/MAILBOUNCE - Détourne le message actuellement sélectionné.\ ARexxAPI/MAILCHANGESUBJECT - Change le sujet du/des message(s) sélectionné(s).\ ARexxAPI/MAILCHECK - Rapatrie les nouveaux messages.\ ARexxAPI/MAILCOPY - Duplique le(s) message(s) sélectionné(s).\ ARexxAPI/MAILDELETE - Efface le(s) message(s) sélectionné(s).\ ARexxAPI/MAILEDIT - Édite le message sélectionné.\ ARexxAPI/MAILEXPORT - Exporte le(s) message(s) sélectionné(s) dans un fichier.\ ARexxAPI/MAILFILTER - Filtre les messages du dossier en cours.\ ARexxAPI/MAILFORWARD - Retransmet le message actuellement sélectionné.\ ARexxAPI/MAILIMPORT - Importe les messages d'un fichier dans le dossier en cours.\ ARexxAPI/MAILINFO - Affiche les informations sur un message donné.\ ARexxAPI/MAILMOVE - Déplace le(s) message(s) sélectionné(s) vers un autre dossier.\ ARexxAPI/MAILREAD - Lit le message sélectionné.\ ARexxAPI/MAILREPLY - Répond au message sélectionné.\ ARexxAPI/MAILSEND - Envoie les messages du dossier en attente.\ ARexxAPI/MAILSENDALL - Envoie tous les messages du dossier en attente.\ ARexxAPI/MAILSTATUS - Change le statut de(s) message(s) sélectionné(s).\ ARexxAPI/MAILUPDATE - Met à jour l'index du dossier en cours.\ ARexxAPI/MAILWRITE - Ouvre une nouvelle fenêtre d'édition pour composer un message.\ ARexxAPI/NEWMAILFILE - Retourne une zone de message libre pour le dossier donné.\ ARexxAPI/QUIT - Quitte YAM.\ ARexxAPI/READCLOSE - Ferme la fenêtre de lecture active.\ ARexxAPI/READINFO - Affiche les informations sur les documents joints dans le message lu.\ ARexxAPI/READPRINT - Imprime un document joint.\ ARexxAPI/READSAVE - Sauvegarde un document joint.\ ARexxAPI/REQUEST - Demande à l'utilisateur de faire un choix.\ ARexxAPI/REQUESTFILE - Demande à l'utilisateur de sélectionner un fichier.\ ARexxAPI/REQUESTFOLDER - Demande à l'utilisateur de choisir un dossier.\ ARexxAPI/REQUESTSTRING - Demande à l'utilisateur une chaîne de caractères.\ ARexxAPI/RESTART - Redémarre YAM\ ARexxAPI/SCREENTOBACK - Place l'écran de YAM en arrière plan.\ ARexxAPI/SCREENTOFRONT - Place l'écran de YAM au premier plan.\ ARexxAPI/SETFLAG - Active l'état PERmanent ou VOLatile d'un message.\ ARexxAPI/SETFOLDER - sélectionne le dossier en cours.\ ARexxAPI/SETMAIL - sélectionne le message en cours dans le dossier en cours par son numéro.\ ARexxAPI/SETMAILFILE - sélectionne le message en cours dans le dossier en cours par son nom de fichier.\ ARexxAPI/SHOW - Désicônifie YAM.\ ARexxAPI/USERINFO - Affiche les informations concernant l'utilisateur actuel.\ ARexxAPI/WRITEATTACH - Joint un fichier au nouveau message.\ ARexxAPI/WRITEBCC - Remplit l'en-tête BCC: d'un nouveau message.\ ARexxAPI/WRITECC - Remplit l'en-tête CC: d'un nouveau message.\ ARexxAPI/WRITEEDITOR - Passe une commande ARexx à l'éditeur interne.\ ARexxAPI/WRITEFROM - Remplit l'en-tête FROM: d'un nouveau message.\ ARexxAPI/WRITELETTER - Charge un fichier texte dans l'éditeur interne.\ ARexxAPI/WRITEMAILTO - Remplit l'en-tête TO: d'un nouveau message.\ ARexxAPI/WRITEOPTIONS - Active des options d'un nouveau message.\ ARexxAPI/WRITEQUEUE - Déplace un nouveau message dans le dossier Outgoing (attente).\ ARexxAPI/WRITEREPLYTO - Remplit l'en-tête REPLY-TO: d'un nouveau message.\ ARexxAPI/WRITESEND - Envoi un nouveau message.\ ARexxAPI/WRITESUBJECT - Remplit l'en-tête SUBJECT: d'un nouveau message.\ ARexxAPI/WRITETO - Remplit l'en-tête TO: d'un nouveau message.\