@DATABASE "AmiTex" @Index INDEXNODE @$VER : version 3.19 (27/8/99) @AUTHOR "FLORAC Roland" @NODE "MAIN" "Sommaire" ----------------------------------- AmiTex Version 3.19 27 août 1999 ----------------------------------- Généralités @{"DISTRIBUTION " LINK Distribution} @{"PRÉSENTATION " LINK Présentation} @{"INSTALLATION " LINK Installation} @{"LANCEMENT " LINK Lancement} Utilisation @{"LES MENUS " LINK Menus} @{"Commandes clavier " LINK "Commandes clavier"} Commandes ARexx @{"Liste alphabétique " LINK Fonctions} @{"Les nombres " LINK Nombres} @{"Liste thématique " LINK "Index thématique"} @{"Chaînes de caractères" LINK "Chaînes de caractères"} Remarques @{"BUGS (?) " LINK Bugs} @{"Historique " LINK Historique} @{"AMÉLIORATIONS futures" LINK Améliorations} @{"L'auteur " LINK Auteur} @ENDNODE @NODE "Distribution" "Distribution" @TOC "MAIN" AmiTex n'appartient pas au domaine public, mais peut être distribué par tous les moyens qui vous conviendront, dans le respect strict des conditions suivantes : - Gratuité : La distribution devra être effectuée SANS CONTREPARTIE, financière ou autre. En particulier il ne pourra être proposé sur un serveur recevant une partie du coût des communications, pas plus que sur une disquette vendue plus cher que son prix d'achat. - Intégralité : Le programme doit être distribué accompagné de tous les fichiers composant le package. - Exceptions : @{"Roland Florac" LINK Auteur}, et lui seul, pourra exceptionnellement accorder une permission de distribution dérogeant aux principes ci-dessus. En particulier, l'inclusion d'AmiTex dans un ensemble de logiciels distribués commercialement devra faire l'objet d'accords écrits. F.F.D. n'a pas le droit de distribuer ce logiciel. - Utilisation : Ce programme est libre (concept Freeware), vous pouvez l'utiliser autant que bon vous semble pour une utilisation personnelle. @ENDNODE @NODE "Présentation" "Présentation" AmiTex est un programme écrit en langage C (SAS C Compiler 5.10a), avec aussi un peu d'assembleur (Devpac 3.14). C'est un éditeur de textes. Il possède une interface ARexx, avec environ 110 commandes, avec la possibilité de définir ses propres fonctions et d'utiliser des variables. Son fonctionnement requiert le système 3.0 au moins. D'autre part certaines fonctions font appel à la bibliothèque @{"gtlayout.library" LINK GTLAYOUT} version 39 ou plus. Celle-ci n'est pas distribuée avec le logiciel, vous pouvez vous la procurer dans le domaine public (site ou CR-ROM Aminet par exemple). Le programme peut lire n'importe quel texte compressé à l'aide d'une des biliothèques de compression fonctionnant sous XPK, de façon transparente pour l'utilisateur. Ce programme permet de travailler sur un nombre de fenêtres théoriquement illimité (sauf par la mémoire disponible !). Vous pouvez bénéficier des fonctions avancées du système 3.0: @{"AppWindows" LINK AppWindows}, @{"AppIcon" LINK AppIcon}, @{"Pools" LINK Pools}... @ENDNODE @NODE "Installation" "Installation" Le programme peut être copié dans tout répertoire, à votre convenance, sous réserve qu'il y ait assez de place libre. J'utilise, pour ma part, le répertoire c:. Le fichier de configuration Amitex.prefs doit être copié dans le répertoire défini par le tootype @{"PREFS" LINK PREFS} (répertoire s: par défaut). Le fichier @{"d'aide" LINK Aide} AmiTex.guide peut être copié dans tout emplacement à votre convenance, vous devrez cependant situer ce fichier à l'aide du tooltype @{"HELPFILE" LINK HELPFILE} de l'icône du programme si vous voulez bénéficier de l'aide en ligne. ATTENTION: le programme, pour fonctionner, fait appel aux ROM 3.0, son fonctionnement est impossible avec une version du système antérieure. @ENDNODE @NODE "Lancement" "Lancement du programme / ToolTypes" La taille de la pile courante du CLI (ou du Shell) peut être fixée à 4 ko (suffisant). AmiTex peut être lancé depuis le CLI ou le Workbench (en cliquant deux fois sur son icône). Lancement depuis le CLI AmiTex [Fichier1] [Fichier2].... L'insertion de "run", permettant de rendre la main au Shell de suite, est inutile, le programme se détachant lui-même du Shell. Les jokers AmigaDOS sont acceptés : AmiTex #?.c ==> tous les fichiers comportant l'extension ".c" seront chargés chacun dans une fenêtre (à condition qu'il y ait suffisamment de mémoire bien sûr). De même AmiTex #?.c #?.s (ou run AmiTex #?.[cs]) sera accepté. Vous pouvez bien sûr lancer le programme sans spécifier de nom de fichier (le nom "Innomé" sera alors utilisé par défaut). Lancement depuis le Workbench Il suffit de cliquer deux fois sur l'icône du programme ou sur celle d'un texte possédant le nom du programme dans son champ TOOL-TYPES. Dans le premier cas vous pouvez utiliser la touche SHIFT pour sélectionner autant de textes que vous le désirez avant de cliquer sur l'icône du programme. L'icône du programme admet trois types d'outils: - le type @{" WINDOW " LINK "OUTIL WINDOW"}, - le type @{"HELPFILE" LINK HELPFILE}, - le type @{"STARTUP " LINK STARTUP}, - le type @{"PUBSCREEN" LINK PUBSCREEN}, - le type @{"ARexx" LINK PathARexx}, - le type @{"PREFS" LINK PREFS} - le type @{" X_ICON " LINK "X_ICON"}, - le type @{" Y_ICON " LINK "Y_ICON"}. Utilisez le menu Information du Workbench pour modifier ces types d'outils. A noter que les requêtes qui apparaissent pour signaler un défaut ou une action peuvent être acquittées en cliquant sur le gadget VU à l'aide de la souris ou en frappant n'importe quelle touche au clavier (pratique...) ou même à l'aide du bouton droit de la souris. De même les boîtes de requêtes proposant un choix (OUI ou NON) peuvent être acquittées de façon classique, à l'aide de la souris, ou bien à l'aide du clavier (ENTER ou RETURN pour OUI, ESC pour NON)... La barre de titre des fenêtres de texte comportent certaines indications: - le nom complet du fichier associé au texte, - la mention " (modifié)" si le texte a été modifié et n'a pas été sauvé, - une parenthèse (, - le code du caractère courant, en hexadécimal (exemple: $41 pour un A), - un espace, - le numéro de colonne courant, - un tiret, - le numéro de ligne courant, - une barre de fraction /, - le nombre de lignes du texte, - une parenthèse ). Les fenêtres possèdent deux ascenseurs: un ascenseur vertical pour faire défiler le texte, ligne par ligne (le nombre de lignes maximal est de 2 puissance 31, soit plus de 2 gigas !), l'ascenseur horizontal permet de le faire défiler colonne par colonne (les lignes possèdent 256 colonnes de texte au maximum). Quatre petits boutons permettent un défilement plus précis (flèches en bas à droite des fenêtres). À noter que les fenêtres peuvent être @{"réduites" LINK Iconify} ("icônifiées"), elles perdent alors tous ces boutons, y compris ceux permettant leur fermeture, leur changement de plan ou leur changement de taille (zoom). @ENDNODE @NODE "HELPFILE" "Type d'outil HELPFILE" @TOC "Lancement" Ce type d'outil permet de déterminer où se situe le fichier @{"d'aide" LINK Aide}. Il doit être suivi du signe = puis du nom du fichier d'aide, avec son chemin complet. Vous pouvez ainsi placer ce fichier où vous le désirez, et même le renommer (cependant non conseillé !) puisque vous devez donner le nom complet du fichier. Exemple: HELPFILE=HELP:AmiTex.guide @ENDNODE @NODE "OUTIL WINDOW" "Type d'outil WINDOW" @TOC "Lancement" Ce type d'outil permet de spécifier les dimensions de la fenêtre ouverte lors du démarrage du programme. Le mot WINDOW doit être suivi du signe = puis des coordonnées du coin supérieur gauche de la fenêtre et de sa largeur puis de sa hauteur. Il ne doit pas y avoir d'espaces entre les données. À noter que les dimensions de la fenêtre sont sauvées avec l'icône du fichier si le menu @{"Préférences/Sauver icône" LINK "Save icon"} est marqué. Ceci permet de retrouver les mêmes dimensions de la fenêtre lors d'un chargement de ce fichier par le Workbench ou en amenant cette icône sur l'icône d'application du programme, présente sur l'écran du Workbench. Exemple: WINDOW=0,1,1000,500 fixe l'emplacement de la fenêtre en haut à gauche de l'écran (il reste une ligne libre en haut pour descendre l'écran du Workbench). La largeur, fixée à 1000, prendra la largeur maximale admissible par l'écran du Workbench (640 pixels ou plus...) et la hauteur est fixée à 500 pixels (également si possible). @ENDNODE @NODE "STARTUP" "Type d'outil STARTUP" @TOC "Lancement" Ce type d'outil permet de lancer l'exécution d'un @{"script ARexx" LINK Script} dès le démarrage du programme, ceci vous permet par exemple de @{"définir" LINK DEF} automatiquement les fonctions que vous souhaitez. Vous pouvez également y inclure les macros que vous souhaitez associer à certaines touches du clavier (voir fonction @{"MAP" LINK MAP}). Ce type doit être suivi du signe = puis du nom du script avec ou sans l'extension amitex. Exemples: STARTUP=REXX:startup.amitex STARTUP=démarrage @ENDNODE @NODE PathARexx "Type d'outil ARexx" @TOC "Lancement" Le type d'outil ARexx permet de situer l'emplacement où Amitex doit retrouver les scripts ARexx. Le chemin par défaut est le répertoire assigné REXX:. J'utilise pour ma part un répertoire spécifique, ce répertoire REXX étant plein d'un tas de scripts d'origine quelque fois douteuse... Exemples: ARexx=REXX: ARexx=SYS:Utilitaires/ARexx @ENDNODE @NODE PREFS "Type d'outil PREFS" @TOC "Lancement" Le type d'outil PREFS permet de situer l'emplacement où Amitex doit retrouver les fichiers de configuration. Le chemin par défaut est le répertoire assigné s:. J'utilise pour ma part le répertoire PROGDIR: Exemples: PREFS=s: PREFS=SYS:Utilitaires/Amitex PREFS=PROGDIR: @ENDNODE @NODE "PUBSCREEN" "Type d'outil PUBSCREEN" @TOC "Lancement" Le type d'outil PUBSCREEN permet de spécifier sur quel écran public doivent être ouvertes les fenêtres gérées par le programme. Si ce type d'outil n'est pas spécifié, les fenêtres seront ouvertes sur l'écran public placé en avant-plan. Sinon elles sont ouvertes sur l'écran du Workbench (par défaut). Exemple: PUBSCREEN=SCIONGEN @ENDNODE @NODE "X_ICON" "Type d'outil X_ICON" @TOC "Lancement" Ce type d'outil permet de déterminer l'abcisse des coordonnées d'affichage de l'icône du programme sur l'écran du Workbench. Il suffit d'ajouter la ligne X_ICON=10 pour que l'icône soit affichée à gauche de l'écran du Workbench. @ENDNODE @NODE "Y_ICON" "Type d'outil Y_ICON" @TOC "Lancement" Ce type d'outil permet de déterminer l'ordonnée des coordonnées d'affichage de l'icône du programme sur l'écran du Workbench. Il suffit d'ajouter la ligne Y_ICON=500 pour que l'icône soit affichée en bas de l'écran du Workbench. @ENDNODE @NODE "Menus" "Les menus" @TOC Main Le programme AmiTex possède 7 menus, pouvant être sélectionnés à l'aide du bouton droit de la souris. @{"Menu Projet " LINK Project} @{"Menu Édition " LINK Edit} @{"Menu Recherche " LINK "Find/Replace"} @{"Menu ARexx " LINK ARexx} @{"Menu Préférences" LINK Preferences} @{"Menu Macros " LINK "Macros"} @ENDNODE @NODE "Project" "Menu Projet" Ce menu possède 15 entrées: @{"Charger " LINK "Load text"} Charge un texte dans la fenêtre active. @{"Insérer " LINK Insert} Insérer un fichier texte dans la fenêtre active. @{"Sauver " LINK "Save text"} Sauve le texte dans le fichier courant. @{"Sauver en " LINK "Save as"} Sauve le texte en spécifiant un nom de fichier. @{"Renommer " LINK Rename} Pour renommer la fenêtre active. @{"Annoter fichier" LINK Filenote} Pour annoter un fichier. @{"Effacer fichier" LINK "Kill file"} Permet de supprimer un fichier. @{"Réduire fenêtre" LINK Iconify} Réduit la fenêtre active (icône). @{"Cacher fenêtre " LINK Hide} Ferme la fenêtre active, le texte reste en mémoire. @{"Autre fenêtre " LINK "Other window"} Ouvre une nouvelle fenêtre. @{"Nouveau " LINK Initialize} Vide la fenêtre courante. @{"Imprimer " LINK Printing} Impression du texte contenu dans la fenêtre active @{"Informations " LINK Informations} Affiche quelques informations. @{"Textes " LINK Texts} Donne la liste des textes actuels. @{"Aide  " LINK "Help?"} Affiche une aide AmigaGuide. @{"Quitter " LINK Quit} Ferme tous les textes. @ENDNODE @NODE "Load text" "Menu Projet/Charger" @TOC Project Ce menu permet de choisir le texte à charger dans la fenêtre active. La boîte de requête de fichiers utilise la bibliothèque asl.library (celle-ci est sur  disque). À noter que celle-ci n'est chargée que lors de l'appel d'une des fonctions qui en a besoin (Chargement, Insertion, Sauver...). Vous pouvez cliquer deux fois sur le nom d'un fichier pour le sélectionner (ou sur VALIDE). La fenêtre prend le nom du fichier chargé. La boîte de requête peut être déplacée ou agrandie, à votre convenance, ses dimensions et sont emplacement seront conservés lors d'une utilisation ultérieure. Si la fenêtre contenait un texte, celui-ci est perdu, sauf s'il avait été modifié mais non sauvé: le programme vous offre alors le choix de continuer l'opération de chargement (l'ancien texte est alors perdu) ou bien d'abandonner, vous permettant alors de le sauver. Raccourci clavier : AMIGA-O (open) ou CTRL-O Nota: vous pouvez également utiliser les fonctions du système 3.0 pour charger un fichier texte: @{"AppIcon" LINK AppIcon} et @{"AppWindows" LINK AppWindows}. @ENDNODE @NODE "Insert" "Menu Projet/Insérer" @TOC Project Ce menu permet d'insérer un fichier texte à l'emplacement où est situé le curseur (choix du fichier à l'aide du requester). Si le curseur n'est pas situé en début de ligne, l'insertion s'effectue quand même AVANT la ligne courante. Raccourci clavier : AMIGA-E ou CTRL-E Nota: vous pouvez également utiliser les fonctions du système 3.0 pour insérer un fichier dans une fenêtre (voir @{"AppWindows" LINK AppWindows}). @ENDNODE @NODE "Save text" "Menu Projet/Sauver" @TOC Project Ce menu permet la sauvegarde du texte dans un fichier disque en utilisant le nom de la fenêtre. Raccourci clavier : AMIGA-S (sauver) ou CTRL-S @ENDNODE @NODE "Save as" "Menu Projet/Sauver en" @TOC Project Ce menu permet de sauvegarder le texte en choisissant le fichier destination à l'aide d'une boîte de requête. Pour cette fonction vous ne pouvez pas cliquer deux fois sur le nom d'un fichier pour le sélectionner (obligation d'utiliser le gadget VALIDE pour éviter les erreurs) Si le nom de fichier choisi correspond à un fichier déjà existant le programme vous demandera une confirmation avant de l'écraser. Si le fichier est différent du fichier courant, le programme vous demande si vous voulez renommer la fenêtre courante en utilisant ce nom version 3.16). Raccourci clavier : AMIGA-A (save As) ou CTRL-A @ENDNODE @NODE "Rename" "Menu Projet/Renommer" @TOC Project Ce menu permet permet de renommer le texte de la fenêtre en cours. Le choix s'effectue à l'aide d'une boîte de requête de fichier. Raccourci clavier : AMIGA-= ou CTRL-= @ENDNODE @NODE "Filenote" "Menu Projet/Annoter fichier" @TOC Project Ce menu permet d'ajouter une note à un fichier choisi (effet analogue à celui de la commande FileNote du DOS). Cette note sera affichée lors de la commande List de l'AmigaDOS. Il n'y a pas de raccourci clavier pour cette fonction. @ENDNODE @NODE "Kill file" "Menu Projet/Effacer fichier" @TOC "Project" Ce menu permet, comme son nom l'indique, de supprimer un fichier... Le fichier est choisi à l'aide du requester (pas de double clic là non plus). Attention à ce que vous faites (il faut plus de temps pour créer un fichier texte que pour l'effacer...). Il n'y a pas de raccourci clavier pour cette fonction (danger...). @ENDNODE @NODE "Iconify" "Menu Projet/Réduire fenêtre" @TOC Project Ce menu permet de réduire les dimensions de la fenêtre texte en cours. Une petite fenêtre apparaît alors en haut de l'écran avec le nom du texte seul. Vous pouvez sélectionner cette fenêtre puis utiliser le bouton droit de la souris ou frapper une touche au clavier pour la faire revenir à son état initial. Cette fonction est bien utile quand on travaille sur de multiples fenêtres (il peut m'arriver d'en avoir jusqu'à quinze...) Vous pouvez déplacer cette fenêtre a n'importe quel emplacement de votre choix, quand cette fonction sera rappelée ultérieurement, cette petite fenêtre reprendra cette place. Raccourci clavier : AMIGA-I (icône) ou CTRL-I @ENDNODE @NODE Hide "Menu Projet/Cacher fenêtre" @TOC Project Ce menu permet de fermer la fenêtre active. Le texte reste cependant en mémoire. Pour faire réapparaître cette fenêtre vous pouvez cliquer deux fois sur l'icône d'application du programme, située sur l'écran du Workbench, ou bien utiliser un double clic sur le bouton droit de la souris, lequel vous permet d'afficher une liste de boutons contenant chacun le nom des diverses fenêtres présentes en mémoire: il suffit alors de cliquer sur celui correspondant à la fenêtre avec laquelle vous désirez travailler pour la ramener au premier plan. @ENDNODE @NODE "Other window" "Menu Projet/Autre fenêtre" @TOC Project Cette fonction permet l'ouverture d'une nouvelle fenêtre. Une requête de fichier permet de choisir le texte à y charger (utilisez le gadget ANNULE si vous ne voulez rien y mettre, mais utilisez alors plutôt la touche F4, comme expliqué ci-dessous). Raccourci clavier : touche de fonction F3. La touche de fonction F4 permet la même chose mais sans provoquer l'ouverture de la requête de fichier. Une nouvelle fenêtre peut être ouverte, en tapant sur F3 ou F4, même à partir d'une fenêtre iconifiée (cette dernière ne sera pas réouverte). @ENDNODE @NODE "Initialize" "Menu Projet/Nouveau" @TOC Project Ce menu sollicite la demande d'effacement du texte présent dans la fenêtre (Attention...). Si le texte a été modifié, vous pourrez cependant le sauver (répondre Oui à la seconde requête). Il n'y a pas de raccourci clavier pour cette fonction. @ENDNODE @NODE "Printing" "Menu Projet/Imprimer" @TOC Project Ce menu permet d'envoyer le texte à l'imprimante (périphérique PRT:). Le programme utilise les Preferences sélectionnées par le système: pilote d'imprimante, qualité, marges, ... Le texte entier est imprimé. Raccourci clavier : AMIGA-P (Print) ou CTRL-P Voir aussi: @{"PRINT" LINK PRINT} @ENDNODE @NODE "Informations" "Menu Projet/Informations" @TOC Project Ce menu provoque l'affichage d'un certain nombre d'informations : copyright, nombre de caractères dans le texte, nom du @{"port" LINK Port} ARexx, quantité de mémoire libre... Raccourci clavier : AMIGA-K ou CTRL-K @ENDNODE @NODE "Texts" "Menu Projet/Textes" @TOC "Project" Ce menu permet d'afficher dans une boîte le nom des différents textes et de leur nombre de lignes (10 textes au maximum). Le rang de la fenêtre (0 à 9) est affiché dans la colonne de gauche. Cette indication est très utile dans le cas où vous travaillez avec de multiples fenêtres: une touche ALT utilisée en conjonction avec l'une des touches 0 à 9 du clavier numérique permet en effet de sélectionner la fenêtre correspondante. Ainsi la combinaison ALT-1 ramène la fenêtre de rang 1 en avant-plan, celle-ci devenant la fenêtre active. Vous pouvez aussi faire défiler les fenêtres en utilisant les combinaisons ALT-+ ou ALT-- (toujours en utilisant les touches + et - du clavier numérique). ALT-+ permet de passer à la fenêtre qui suit alors que ALT-- ramène la précédente. À noter l'indicateur + ou - signalant si le texte a été modifié. Enfin une dernière possibilité permet de changer de texte sans utiliser le clavier: un double clic sur le bouton droit de la souris amène une boîte de requête sur la fenêtre de travail, la liste des textes y figure (sans le chemin complet, seul figure le nom du fichier), il suffit alors de cliquer sur le bouton correspondant au nom du texte souhaité pour ramener sa fenêtre en avant plan. Raccourci clavier : AMIGA-. ou CTRL-., double clic bouton droit ou combinaison ALT-N° fenêtre @ENDNODE @NODE "Help?" "Menu Projet/Aide spécifique" @TOC Project Ce menu permet d'obtenir une aide à l'aide du programme AmigaGuide. Vous devez pour cela spécifier le nom d'un node appartenant au fichier AmiTex.guide. Ce fichier contient notamment des nodes pour chacunes des macros ARexx (Ex: COPY, PASTE...) À noter que vous pouvez également obtenir une aide à partir de chacune des entrées de menu en sélectionnant l'un de ces menus et en appuyant simultanément sur la touche HELP. Enfin, si un message d'erreur concernant une fonction apparaît, vous pouvez appeler l'aide concernant cette fonction en appuyant sur la touche HELP alors que la fenêtre affichant le message d'erreur est active. À noter également que vous pouvez obtenir une aide sur un thème en sélectionnant ce terme à l'aide de la souris (passage en surbrillance) puis en appuyant sur la touche HELP. Si les mots sélectionnés composent le nom d'un "node" du fichier AmigaGuide, l'aide correspondante sera affichée. Cela est particulièrement utile lors de l'écriture de scripts ARexx, afin de se rappeler du fonctionnement de certaines fonctions. Raccourci clavier: AMIGA-? ou CTRL-? @ENDNODE @NODE "Quit" "Menu Projet/Quitter" @TOC Project Ce menu permet de fermer toutes les fenêtres et de supprimer tous les textes de la mémoire. Le programme quitte également en libérant la mémoire qui'il occupait. Si l'un des textes a été modifié, une sauvegarde sera proposée. Raccourci clavier : AMIGA-Q (quitter) CTRL-Q (ne ferme que la fenêtre active) @ENDNODE @NODE "AppIcon" "Icône d'application AmiTex" @TOC MAIN Le concept d'AppIcon (Icône d'application) autorise le chargement d'un fichier de façon très simple, en une seule action, à l'aide de la souris. Comme décrit, dans l'introduction, le programme crée une icône qui apparaît sur l'écran du Workbench, lors de son @{"lancement" LINK Lancement}. Cette icône porte le nom d'AmiTex. Il vous suffit de "saisir" une icône correspondant à un fichier texte quelconque, à l'aide de la souris, et de la faire glisser sur cette icône pour que ce fichier soit chargé dans une nouvelle fenêtre. Cette icône possède également une autre fonction: en cliquant deux fois dessus rapidement, avec le bouton gauche, vous pouvez "réveiller" le programme si toutes les fenêtres sont cachées (la fenêtre active est réouverte), ou faire passer en avant-plan la fenêtre active si celle-ci est cachée. Cette action peut également permettre un déblocage éventuel, provoqué par une mauvaise utilisation de la fonction @{"LOCK" LINK LOCK} dans un @{"script" LINK Script} ARexx. @ENDNODE @NODE "AppWindows" "Chargement de fichiers textes à l'aide des AppWindows" @TOC MAIN Toutes les fenêtres ouvertes en mode "normal" (c'est à dire qui ne n'ont pas été @{"réduites" LINK Iconify}), sont des AppWindows. Cette fonction est gérée par le système 3.0 et permet de détecter le "largage" d'une icône sur ces fenêtres. La conséquence pour l'utilisateur est que pour charger un texte dans une fenêtre, il suffit de cliquer sur son icône avec le bouton gauche de la souris, puis de faire glisser celle-ci sur cette fenêtre, en maintenant le bouton appuyé. Attention: le nouveau texte sera INSÉRÉ dans la fenêtre si celle-ci n'est pas vide. L'insertion s'effectuant à partir de la ligne sur laquelle vous avez déposé l'icône. Si vous voulez charger ce texte dans une nouvelle fenêtre, déposez l'icône sur l'@{"AppIcon" LINK AppIcon} du programme, présente sur l'écran du Workbench, ou ouvrez d'abord une @{"nouvelle" LINK "Other window"} fenêtre (En appuyant sur F4, par exemple). @ENDNODE @NODE "Pools" "Gestion de la mémoire" @TOC MAIN Les pools correspondent à un concept de gestion de la mémoire amélioré, permettant de ne pas trop fragmenter la mémoire. En effet chaque ligne est mémorisée de façon dynamique, dans une zone mémoire qui est allouée au programme au fur et à mesure des besoins. Ceci a généralement pour conséquence de créer de nombreuses zones de mémoire libre et occupée, en alternance, dans la mémoire de votre Amiga. Grâce à ce concept, cet effet est beaucoup diminué, et surtout la vitesse est notamment améliorée. Malheureusement ce concept exige l'utilisation du système 3.0 au moins. @ENDNODE @NODE "Find/Replace" "Menu Recherche" @TOC Menus Cet ensemble de menus permet de rechercher et de remplacer des @{"chaînes de caractères" LINK "Chaînes de caractères"} dans le texte. @{"Rechercher " LINK Set} Détermine les chaînes recherchée et de remplacement @{"Chercher avant " LINK "Find previous"} Lance la recherche après le curseur @{"Chercher après " LINK "Find next"} Lance la recherche avant le curseur @{"Chercher Sélection" LINK Selection} Lance la recherche du bloc de texte sélectionné @{"Remplacer avant " LINK "Replace previous"} @{"Remplacer après " LINK "Replace next"} @{"Jusqu'à la fin " LINK "Replace all"} @{"MAJ=min " LINK "UPPER=lower"} @{"Aller à ligne " LINK "Goto line"} @ENDNODE @NODE "Set" "Menu Recherche/Rechercher" @TOC "Find/Replace" Cette fonction ne peut fonctionner que si vous avez installé la bibliothèque @{"gtlayout" LINK GTLAYOUT}.library, version 39 ou plus. Celle-ci est disponible dans le domaine public (disques DP ou CD-ROM Aminet). Une fenêtre s'ouvre lors de l'appel de cette fonction : vous y trouvez deux boîtes de texte (Chaîne à chercher et chaîne à remplacer) ainsi que divers autres gadgets (Avant, Après, Autres, etc...). La saisie d'une chaîne dans la première de ces boîtes détermine naturellement quelle sera la chaîne à chercher. La recherche s'effectue après la position courante du curseur, en sélectionnant le bouton "Après". Le bouton "Avant" permet la recherche d'une chaîne avant la position courante du curseur (en remontant vers le début du texte). Le bouton "Autre" initialise la boîte de texte. La boîte "Remplacer", contient la chaîne de remplacement éventuelle, enfin le bouton "MAJ=min" permet de déterminer la sensibilité aux minuscules et majuscules lors des recherches. Quand il est marqué les mots écrits en majuscules (M) ou en minuscules (m) seront indifféremment détectés, y compris pour les lettres accentuées. Ainsi la recherche permettra par exemple de trouver indifféremment "près", "Près" ou "PRÈS". Le bouton "Restaurer" permet d'annuler un remplacement effectué après avoir cliqué l'un des boutons "Avant" ou "Après" situé sous la boîte contenant le texte de remplacement. Cette annulation doit impérativement avoir lieu avant que le curseur ne quitte la ligne où a eu lieu ce remplacement. A noter : - Une recherche infructueuse est signalée par un clignotement de l'écran (chaîne non trouvée ou absence de chaîne à chercher). - La fenêtre "Recherche" n'a pas forcément a être fermée, vous pouvez continuer à travailler normalement dans l'une ou l'autre des fenêtres textes en y cliquant à l'intérieur. Vous pouvez refermer cette fenêtre en cliquant dans le bouton de fermeture en haut à gauche de la fenêtre ou en tapant sur la touche Esc. Les raccourcis clavier pour la sélection au clavier d'un des boutons sont signalés par un caractère souligné (a pour Avant, ...). Raccourci clavier : AMIGA-F (find) ou CTRL-F pour appeler cette fenêtre @ENDNODE @NODE "Find previous" "Menu Recherche/Chercher Avant" @TOC "Find/Replace" Ce menu permet de lancer la recherche du texte choisi avant la position courante du curseur (sans remplacement). Si le texte choisi n'a pas été défini, la @{"fenêtre de recherche" LINK Set}, contenant la boîte permettant sa définition est ouverte. Raccourci clavier : AMIGA-B (back), CTRL-B ou F5 @ENDNODE @NODE "Find next" "Menu Recherche/Chercher Après" @TOC "Find/Replace" Ce menu permet de lancer la recherche du texte choisi après la position courante du curseur (sans remplacement). Raccourci clavier : AMIGA-N (next), CTRL-N ou F6 @ENDNODE @NODE "Selection" "Menu Recherche/Sélection" @TOC "Find/Replace" Le mot ou la phrase sélectionné à l'aide de la souris devient la chaîne à chercher. La recherche s'effectue ensuite vers la fin du texte. Attention, la sélection ne doit se faire que sur une seule ligne à la fois. Raccourci clavier : AMIGA-J ou CTRL-J @ENDNODE @NODE "Replace previous" "Menu Recherche/Remplacer avant" @TOC "Find/Replace" Ce menu permet la recherche et le remplacement avant la position actuelle du curseur. Raccourci clavier : AMIGA-Z ou CTRL-Z @ENDNODE @NODE "Replace next" "Menu Recherche/Remplacer après" @TOC "Find/Replace" Ce menu permet la recherche et le remplacement après la position actuelle du curseur. Raccourci clavier : AMIGA-R (replace) ou CTRL-R @ENDNODE @NODE "Replace all" "Menu Recherche/Jusqu'à la fin" @TOC "Find/Replace" Lance la recherche et le remplacement de toutes les occurences du texte choisi, ceci jusqu'à la fin du texte (toujours à partir de la position du curseur) : attention... Il n'y a pas de raccourci clavier pour cette fonction, qui ne peut être interrompue avant que la recherche n'ait échoué... @ENDNODE @NODE "UPPER=lower" "Menu Recherche/MAJ=min" @TOC "Find/Replace" Ce menu, quand il est marqué, permet de lancer une recherche sans distinguer les majuscules des minuscules dans le texte. Sélectionnez à nouveau ce menu pour annuler son action. Raccourci clavier: AMIGA-ù ou CTRL-ù @ENDNODE @NODE "Goto line" "Menu Recherche/Aller à ligne" @TOC "Find/Replace" Ce menu permet de choisir le numéro de la ligne où vous souhaitez déplacer le curseur. Le numéro de la ligne courante est indiqué dans la boîte de requête. Pour ma part j'utilise le plus souvent le gadget proportionnel situé à droite de la fenêtre pour déplacer le curseur dans le texte (ou même les deux flèches en bas à droite). Cette fonction m'est utile pour aller à une ligne où est située une erreur signalée par le compilateur C (celui-ci indiquant son numéro). Raccourci clavier : AMIGA-G (Go) ou CTRL-G @ENDNODE @NODE "Edit" "Menu Édition" @TOC Menus Les premiers menus sont relatifs aux blocs de texte. Avant de commencer leur description il faut expliquer comment sont sélectionnés ces blocs. Cette sélection s'effectue en faisant glisser le curseur sur la zone de texte à sélectionner, tout en maintenant le curseur gauche de la souris appuyé. Vous pouvez aussi sélectionner un mot en cliquant deux fois sur la première lettre déterminant le début du mot. En cliquant sur un caractère non alphabétique, vous sélectionnez la ligne entière. Pour annuler la sélection d'un bloc pressez la touche ESC ou cliquez à nouveau n'importe où sur l'écran. Quand un bloc est déjà sélectionné, vous pouvez l'étendre sans avoir à faire glisser le curseur tout au long du texte à sélectionner: pressez une des touches SHIFT avant de cliquer avec le bouton gauche de la souris à l'emplacement souhaité pour la fin de la sélection. Vous pouvez ainsi sélectionner tout un ensemble de lignes en positionnant le curseur au début du texte choisi, vous utilisez ensuite l'ascenseur pour faire défiler le texte (le bloc reste marqué), quand la fin du bloc désiré apparaît vous n'avez plus qu'à y cliquer avec le bouton gauche de la souris tout en maintenant une des touches SHIFT pressée. De même vous pouvez utiliser la touche CTRL mais c'est alors le début de la zone sélectionnée qui est déplacé (plus délicat, essayez...). Les fonctions Copier, Coller et Couper utilisent le presse-papiers de l'Amiga (clipboard.device) rendant ainsi ces opérations possibles en liaison avec d'autres tâches (traitement de textes ou autres). Le numéro de l'unité du presse-papiers utilisé peut être changé à l'aide de la fonction ARexx @{"CLIPUNIT" LINK CLIPUNIT}. Quand un bloc est sélectionné toute écriture qui s'effectue dans le bloc lui-même entraîne d'abord l'effacement du bloc. Deux raccourcis clavier intéressants, en rapport avec les blocs, sont les suivants : CTRL HELP permet le déplacement du curseur au début du bloc. SHIFT HELP permet le déplacement du curseur à la fin du bloc. @{"Copier " LINK "Copy block"} @{"Coller " LINK "Paste clip"} @{"Couper " LINK "Cut block"} @{"Sauver " LINK "Write block"} @{"Indenter => " LINK "Indent =>"} @{"Indenter <= " LINK "Indent <="} @{"MAJUSCULES " LINK "UPPER CASE"} @{"minuscules " LINK "Lower case"} @{"Effacer ligne " LINK "Kill line"} @{"Récupère ligne" LINK "Recall line"} @{"Restaure ligne" LINK "Undo line"} @{"Insertion " LINK "Insert mode"} @ENDNODE @NODE "Copy block" "Menu Édition/Copier" @TOC Edit Ce menu permet la recopie du bloc spécifié dans le presse-papiers. Si l'opération réussit, la sélection est annulée. Raccourci clavier : AMIGA-C (copier) ou CTRL-C @ENDNODE @NODE "Paste clip" "Menu Édition/Coller" @TOC Edit Le contenu du presse-papiers est copié à l'emplacement actuel du curseur. Si le curseur est placé dans une zone de texte qui a été sélectionnée, ce texte est d'abord effacé. Attention: le @{"mode courant" LINK "Insert mode"} (insertion ou surimpression) est pris en compte, aussi faites attention si vous travaillez en mode surimpression, surtout quand vous collez plusieurs lignes en même temps... Raccourci clavier: AMIGA-V ou CTRL-V @ENDNODE @NODE "Cut block" "Menu Édition/Couper" @TOC Edit Ce menu permet d'effacer le bloc spécifié (le bloc est copié dans le presse-papiers). Raccourci clavier : AMIGA-X ou CTRL-X @ENDNODE @NODE "Write block" "Menu Édition/Sauver" @TOC Edit Ce menu permet de sauvegarder le bloc sélectionné dans un fichier (choisi à l'aide d'une requête). Raccourci clavier : AMIGA-W ou CTRL-W @ENDNODE @NODE "Indent =>" "Menu Édition/Indenter ==>" @TOC Edit Ce menu permet l'insertion d'une tabulation sur chacune des lignes du bloc (en début de ligne). Raccourci clavier : AMIGA-TAB (tabulation) @ENDNODE @NODE "Indent <=" "Menu Édition/Indenter <==" @TOC Edit Ce menu permet la suppression d'UNE tabulation sur chacune des lignes du bloc. Cette suppression a lieu au début de la ligne, s'il y existe des espaces. Raccourci clavier : AMIGA-BACKSPACE (touche de correction) @ENDNODE @NODE "UPPER CASE" "Menu Édition/MAJUSCULES" @TOC Edit Ce menu convertit tout le bloc sélectionné en majuscules (lettres accentuées comprises, pratique pour insérer des É, ÈÎ...). Si aucun texte n'est sélectionné, seul le caractère présent sous le curseur est converti. Raccourci clavier : AMIGA-H (High) ou CTRL-H @ENDNODE @NODE "Lower case" "Menu Édition/Minuscules" @TOC Edit Ce menu convertit tout le bloc sélectionné en minuscules (lettres accentuées comprises). Si aucun texte n'est sélectionné, seul le caractère présent sous le curseur est converti. Raccourci clavier : AMIGA-L (Low) ou CTRL-L @ENDNODE @NODE "Kill line" "Menu Édition/Effacer ligne" @TOC Edit Ce menu supprime la ligne courante. Cette ligne peut ensuite être "rappelée" en faisant la combinaison ALT-DEL, à l'emplacement où est situé le curseur. Raccourci clavier : AMIGA-Y ou CTRL-Y ou CTRL-DEL @ENDNODE @NODE "Recall line" "Menu Édition/Récupère ligne" @TOC Edit Ce menu ramène la ligne précédement supprimée à l'aide du menu précédent à l'emplacement du curseur. Raccourci clavier: ALT-DEL @ENDNODE @NODE "Undo line" "Menu Édition/Restaure ligne" @TOC Edit Ce menu entraîne l'annulation des modifications apportées à la ligne en cours. Ne sera effectif que si le curseur n'a pas quitté la ligne en question. Cette fonction est utilisable aussitôt après un remplacement (souvent utile). Raccourci clavier : AMIGA-U (Undo) ou CTRL-U @ENDNODE @NODE "Insert mode" "Menu Édition/Insertion" @TOC Edit Cette marque signale si la frappe s'effectue en mode insertion (par défaut) ou en surimpression. Dans ce mode les lettres entrées au clavier remplacent celles où est situé le curseur. Ce mode est signalé par la couleur du curseur, qui est modifiée dans ce mode (noir au lieu de bleu). Chaque appel de ce menu entraîne sa modification (marqué, non marqué, etc...) Raccourci clavier : AMIGA-: ou CTRL-: @ENDNODE @NODE "ARexx" "Menu ARexx" @TOC Menus Cette série de menus est dédiée aux @{"scripts ARexx" LINK Script}. @{"Appel script" LINK "Call script"} Appel d'un script ARexx choisi. @{"ARexx... " LINK "ARexx..."} Appel (programmable) de 20 scripts. @ENDNODE @NODE "Call script" "Menu Macros/Appel script" @TOC Macros Ce menu permet la saisie d'une commande ARexx (donnez le nom du @{"script" LINK Script}, l'extension ".amitex" n'est pas obligatoire). Raccourci clavier : AMIGA-, ou CTRL-, @ENDNODE @NODE "Port" "Port ARexx" @TOC Macros Le programme ouvre normalement un port de communication avec l'interpréteur ARexx lors de son lancement, ce port s'appelle AMITEX. Si le programme est lancé plusieurs fois, le port est appelé AMITEX0 par la seconde tâche, puis AMITEX1 pour la suivante, et ainsi de suite jusqu'à AMITEX9. @ENDNODE @NODE "ARexx..." "Menu Macros/ARexx..." @TOC Macros Ces 20 menus servent à définir 20 commandes pouvant être lancés par la sélection du menu correspondant. Lors du premier appel du menu, l'utilisateur définit sa commande. Les appels qui suivront permettent alors l'appel du @{"script" LINK Script} défini. Le nom du script apparaît ensuite dans le menu. Les 20 définitions peuvent être sauvegardées dans le fichier AmiTex.prefs, et rechargées automatiquement lors de l'appel du programme. Ces menus peuvent être redéfinis en appuyant sur l'une des touches SHIFT lors de la sélection du menu. À noter que l'édition du script défini peut être faite de façon automatique dans une nouvelle fenêtre en appelant le menu tout en maintenant la touche CTRL appuyée (le nom doit naturellement avoir été défini auparavant). La commande doit comporter le nom du script à exécuter (toujours sans l'extension ".amitex"). Le nom ne peut compter que 11 caractères au maximum. Il n'est pas possible de transmettre de paramètres au script. Les communications avec ARexx se font grâce au @{"port" LINK Port} AMITEX (ou AMITEX0, AMITEX1...AMITEX9 si plusieurs tâches sont exécutées en même temps). Utilisez la commande port=ADDRESS() pour connaître le nom du port, si nécessaire (voir le script conjugue.amitex pour exemple). Raccourcis clavier : AMIGA-0 à AMIGA-9 @ENDNODE @NODE "Preferences" "Menu Préférences" @TOC Menus Cette série de menus permet de sauvegarder certains réglages du programme dans le fichier configuration.amitex. Ce fichier est sauvé dans le répertoire assigné "s:". Ce fichier est relu automatiquement à chaque démarrage du programme, afin de repositionner les réglages comme voulu par l'utilisateur. @{"Sauver tabulations" LINK "Save tabs"} @{"Copie texte sauvé " LINK "Backup text"} @{"Sauver avec icône " LINK "Save icon"} @{"Tabulations = 4 " LINK Tabulations} @{"Choix police " LINK Font} @{"Configuration " LINK Configuration} @ENDNODE @NODE "Save tabs" "Menu Préférences/Sauver tabulations" @TOC "Preferences" Cette bascule permet ou interdit l'écriture du caractère TAB (0x9) dans le fichier lors de la sauvegarde. Si ce menu n'est pas marqué les tabulations seront remplacées par des espaces. Son utilisation permet de diminuer de façon conséquente la taille des fichiers. @ENDNODE @NODE "Backup text" "Menu Préférences/Copie texte sauvé" @TOC Preferences Quand ce menu est marqué, lors de la sauvegarde, l'ancienne version est sauvegardée avec l'extension ".bis" à la fin du nom. @ENDNODE @NODE "Save icon" "Menu Préférences/Sauver icône" @TOC Preferences Si ce menu est marqué une icône est créée lors de la sauvegarde du texte. Le nom du programme figure dans le champ TOOL-TYPES. L'icône utilisée est l'icône "Projet" par défaut, stockée dans le répertoire ENV:. @ENDNODE @NODE "Tabulations" "Menu Préférences/Tabulations = x" @TOC Preferences Ce menu permet de déterminer l'espace entre les tabulations pour la touche TAB (4 par défaut) lors de la saisie clavier (valide aussi pour les menus INDENTER vus précédemment). @ENDNODE @NODE "Font" "Menu Préférences/Choix police" @TOC Preferences Ce menu permet de choisir la fonte utilisée pour écrire le texte dans les fenêtres. Chacune des différentes fenêtres peut utiliser une fonte différente. Cependant cette fonte n'est pas utilisée pour l'affichage des menus. Seules les fontes non proportionnelles sont admises. En l'absence de fichier de configuration (voir ci-dessous), c'est la fonte choisie pour l'écran qui est utilisée. Attention alors à ne pas utiliser une fonte proportionnelle, le programme ne les gère pas correctement. Raccourcis clavier : AMIGA-[ ou CTRL-[ @ENDNODE @NODE "Configuration" "Menu Préférences/Configuration" @TOC Preferences Ce menu comporte trois rubriques, permettant de sauver ou de lire les macro-commandes associées aux touches de fonction, les noms des @{"scripts ARexx" LINK Script} choisis, les divers modes (tabulations, sauver avec ou sans icône, sauver avec les tabulations, copie texte...) et les définitions évntuellement attachées à certaines combinaisons de touches (comme alt-a par exemple, définies à l'aide de la fonction @{"MAP" LINK MAP}). Le fichier de configuration Amitex.prefs peut se trouver où l'utilisateur le désire (c'est dans le répertoire s: par défaut), en utilisant le tooltype @{"PREFS" LINK PREFS}. CHARGER : permet de relire le fichier de configuration de votre choix, préalablement sauvé grâce à l'option SAUVER ou SAUVER EN. SAUVER : permet la sauvegarde des préférences dans le fichier AmiTex.prefs. Ce fichier est relu à chaque chargement du programme. SAUVER EN : permet la sauvegarde des préférences dans un fichier, de votre choix (requête asl.library). Lors d'une sauvegarde des préférences, c'est la fonte alors utilisée dans la fenêtre active qui est sauvée (nom et taille). @ENDNODE @NODE "Macros" "Menu Macros" @TOC Menus Ce menu possède, à l'origine, seulement deux entrées. Il peut cependant être configuré afin d'en avoir davantage. Menu @{"Mode direct " LINK "Direct mode"} Menu @{"Ajouter menu" LINK "Add menu"} Menu @{"Éditer label" LINK "Edit label"} Menu @{"Éditer macro" LINK "Edit macro"} Menu @{"Supprimer menu" LINK "Remove menu"} @ENDNODE @NODE "Direct mode" "Menu Macros/Mode direct" @TOC Macros Ce menu permet la saisie d'une @{"macro-commande" LINK "Ecriture commandes"}, puis son exécution. À noter que vous pouvez également utiliser la combinaison d'une touche ALT et d'une touche de fonction pour obtenir 10 macros préprogrammées. Il faut noter que ces séquences programmées sont sauvegardées dans le fichier Amitex.prefs, à l'aide du menu @{"Préférences/Configuration/Sauver" LINK Configuration}. Celles-ci sont alors rechargées lors de chaque lancement du programme. Vous pouvez provoquer l'affichage du résultat de la commande en faisant commencer le texte spécifiant cette commande par le signe égal (=). Exemple: =4*95 affiche le résultat de la multiplication (4 fois 95) =LINE affiche le numéro de la ligne courante =COL affiche le numéro de la colonne courante Raccourci clavier : AMIGA-; ou CTRL-; @ENDNODE @NODE "Add menu" "Menu Macros/Ajouter menu" @TOC Macros Ce menu permet l'ajout de menus définis par l'utilisateur. Pour ajouter une nouvelle entrée à ce menu, il suffit de sélectionner le menu "Ajouter menu": le logiciel ouvre alors une boîte de requête pour demander quelle est la macro commande à associer à ce nouveau menu. Vous pouvez alors saisir n'importe quelle expression utilisant toutes les commandes ARexx définies par Amitex, y compris l'appel d'un script ARexx en utilisant la fonction CALL. Si vous validez votre saisie, le logiciel vous demande ensuite quel est le nom à associer à ce menu, entrez alors un nom définissant le mieux ce que la macro ou le script va faire. La prochaine fois que vous allez sélectionner le menu, ce nom va apparaître en fin de liste, si vous le sélectionnez la commande que vous avez défini précédemment sera exécutée. ATTENTION: si vous essayez de définir un menu possédant un nom ou une macro identique à ceux d'un des menus déjà définis, votre définition ne sera pas ajoutée à la liste existante. Pour définir une barre horizontale de séparation, ne donnez rien dans la requête de macro commande (Validez simplement), puis entrez la définition BAR dans la requête demandant le nom du menu. @ENDNODE @NODE "Edit label" "Menu Macros/Éditer label" @TOC Macros Ce menu permet de modifier l'intitulé d'un menu défini par l'utilisateur. Il suffit de sélectionner ce menu puis de cliquer sur le label du menu à modifier dans la fenêtre qui s'ouvre ensuite pour réaliser cette opération. Spécifiez le label BAR pour obtenir une barre de séparation entre des menus successifs. @ENDNODE @NODE "Edit macro" "Menu Macros/Éditer macro" @TOC Macros Ce menu permet de modifier la macro-commande associée à un menu défini par l'utilisateur. Il suffit de sélectionner ce menu puis de cliquer sur le label du menu à modifier dans la fenêtre qui s'ouvre ensuite pour réaliser cette opération. Les @{"macro-commandes" LINK "Ecriture commandes"} peuvent utiliser toutes les @{"fonctions" LINK Fonctions} ARexx disponibles. Pour appeler un @{"script" LINK Script} ARexx, utilisez la fonction @{"CALL" LINK CALL}. @ENDNODE @NODE "Remove menu" "Menu Macros/Supprimer menu" @TOC Macros Ce menu permet de supprimer l'un des menus précédemment définis, s'il en existe. Il suffit de cliquer sur le nom du menu qui vous intéresse, dans la fenêtre ouverte après avoir sélectionné ce menu, pour que l'opération soit effectuée. Cliquez dans le bouton de fermeture de la fenêtre si vous désirez annuler l'opération. @ENDNODE @NODE "Ecriture commandes" "Écriture d'une ligne de commande(s)" @TOC "Macros" Les macro-commandes peuvent être exécutées en mode local ou bien par l'intermédiaire d'un @{"script ARexx" LINK Script}. Vous pouvez vous reporter aux scripts donnés en exemple, dans le répertoire "s:ARexx". Ceux-ci doivent posséder l'extension ".amitex" à leur nom. Chacune de ces macro-commandes peut appeler l'une des fonctions ARexx, ou même plusieurs. Certaines d'entre elles nécessitent un ou plusieurs arguments, enfin la plupart d'entre elles retournent un résultat. Le programme permet aussi de manipuler des @{"variables" LINK Variable} (des types numérique ou chaîne de caractères). De plus vous pouvez définir vos propres fonctions. L'appel d'une fonction se fait en donnant son nom, suivi d'un ou plusieurs arguments, entourés de parenthèses, éventuellement séparés par des virgules. Les opérateurs mathématiques classiques sont bien sûr disponibles : opérateur signe priorité élévation à une puissance : ^ 10 division : / 9 multiplication : * 9 modulo : % 9 addition : + 8 soustraction : - 8 ET logique : & 6 OU exclusif : ? 5 OU logique : | 4 affectation : = 2 Ce dernier opérateur (=) peut être utilisé pour affecter les @{"variables" LINK Variable}. Ex : A=2, affecte la valeur 2 à la variable A. Il est à noter que l'écriture A=B=3 n'est pas admise, elle entraînera un message d'erreur "Affectation impossible". Autres opérateurs : décalage à gauche : << décalage à droite : >> Ces deux opérateurs ont une priorité égale à 7. test supérieur : > test supérieur ou égal : >= test inférieur : < test inférieur ou égal : <= test si différent : <> test égalité : == Les tests renvoient la valeur 1 s'ils sont vérifiés, 0 dans les autres cas. Leur priorité est égale à 3. Il existe un opérateur particulier qui en fait n'en est pas un, c'est le signe :, celui-ci permet en fait de séparer deux formules (ou davantage) afin de pouvoir saisir plusieurs affectations de @{"variables" LINK Variable} dans une même fonction. Ainsi vous pouvez saisir A=2:B=3:C=0 dans une seule cellule au lieu d'en utiliser trois. Le résultat renvoyé est alors celui de la dernière opération réalisée (0 dans cet exemple). Cette possibilité peut également présenter un intérêt pour une fonction FOR (voir plus loin), afin de réaliser de multiples initialisations au début d'une boucle. Enfin il est à noter que vous pouvez placer un commentaire dans une macro comportant une expression mathématique en utilisant l'apostrophe vue plus haut. Exemple: GOTO(1,BLOCK(1)) ' Déplacement au début du bloc Enfin, vous pouvez placer plusieurs appels de fonctions sur une même ligne, en les séparant par deux points. Exemple: GOTO(1,1) : WRITE("Essai") @ENDNODE @NODE "Variable" "Les variables" @TOC "Macros" Les variables manipulées par AmiTex peuvent être de deux types: @{b}numérique@{ub} ou @{b}chaîne de caractères@{ub}. Le type est choisi lors de l'affectation, il ne peut ensuite être changé, à moins de réinitialiser cette variable (voir fonction @{"INIT" LINK INIT}). Pour affecter une valeur à une variable il suffit de faire suivre son nom du signe = et de la valeur à lui affecter. Exemples: A = 1 B2 = "chaîne de texte" A2 = "Première "+B2 donne "Première chaîne de texte" Les @{"chaînes de caractères" LINK "chaînes de caractères"} doivent être encadrées par des guillemets s'il s'agit de constantes. Les @{"valeurs numériques" LINK Nombres} sont limitées aux entiers, utilisez ARexx pour manipuler des nombres réels. Les noms de variables peuvent comprendre de 1 à 21 caractères, ils doivent débuter par une lettre, les caractères suivants pouvant être des lettres (accentuées ou non), des nombres ou le caractère _. Exemples de noms valides: ESSAI TYPE_DONNÉE LIGNE1 À noter que le programme convertit normalement les noms de fonctions et de variables en majuscules lors de la saisie, aussi n'y aura-t-il pas de différence entre deux noms comme variable et VARIABLE (ou même Variable), cependant dans un @{"script ARexx" LINK Script}, utilisez de préférence les majuscules car les chaînes issues de l'interpréteur ne sont pas forcément converties, et le programme différenciera alors les noms écrits en minuscules et/ou en majuscules. @ENDNODE @NODE "Nombres" "Les variables numériques" @TOC Maths Les nombres manipulés par Amitex sont limités aux nombres entiers. Ceux ci sont des entiers longs signés, sur 32 bits. La valeur maximale est doc de 2^31-1 (2147483647) et la valeur minimale -2^31 (-2147483648). Utilisez les capacités de l'interpréteur ARexx pour manipuler des nombres en virgule flottante. @ENDNODE @NODE "Chaînes de caractères" "Les chaînes de caractères" @TOC Variable Les chaînes de caractères comprennent un nombre quelconque de caractères (théoriquement limité uniquement par la capacité mémoire de votre micro-ordinateur), en commençant par les chaînes nulles qui ne comprennent aucun caractère. Pour définir une chaîne de caractères, vous devez encadrer son contenu par deux guillemets. Si cette chaîne comprend elle-même un ou plusieurs guillemets, ceux-ci doivent être doublés. Exemples: "Ceci est une chaîne de caractères" "" "C'est un guillemet "" !" @ENDNODE @NODE "Script" "Structure des scripts ARexx" Les scripts ARexx sont des fichiers ASCII, se conformant à un format permettant leur interprétation par ce logiciel. Ils peuvent inclure toutes les fonctions spécifiques à ARexx et à ses bibliothèques (reportez-vous à leurs documentations pour plus de précisions), ainsi que toutes les commandes supportées par le programme AmiTex (une centaine, plus les fonctions éventuellement définies par vos soins). @{b}Emplacement@{ub} Utilisez le tooltype #{"ARexx" LINK PathARexx} pour définir le répertoire dans lequel vous voulez copier les scripts gérés par Amitex. Par défaut ces scripts doivent se situer dans le répertoire assigné REXX: (conseillé). Il est conseillé de les nommer avec l'extension .AmiTex, mais ce n'est pas obligatoire. @{b}Format@{ub} Ces scripts doivent toujours commencer par une remarque incluse entre les caractères /* et */, comme en langage C. Les commandes AmiTex doivent impérativement figurer en majuscules. Ce sont les mêmes que celles qui sont utilisées en @{"mode local" LINK "Direct mode"}, cependant leur analyse par ARexx nécessite quelques précautions, ainsi ces commandes doivent impérativement être encadrées par des apostrophes (') ou des guillemets, afin de les différencier des fonctions internes à ARexx. @{b}Exemple@{ub} La structure suivante est recommandée pour ces scripts: /* Ce fichier vous donne un exemple de structure possible pour un fichier de macros appelé par AmiTex, par le menu Macros */ options results /* indispensable pour récupérer le résultat des macros */ signal on error /* pour l'interception des erreurs */ signal on syntax /* votre programme doit être situé dans cette zone */ exit /* Traitement des erreurs, interruption du programme */ syntax: erreur=RC 'MESSAGE("Erreur de syntaxe"+CHR(10)+"en ligne 'SIGL'"+CHR(10)+"'errortext(erreur)'")' exit error: 'MESSAGE("Erreur en ligne 'SIGL'")' exit Cet exemple existe déjà prêt dans le répertoire Rexx, sous le nom @{b}squelette.amitex@{ub}. @ENDNODE @NODE "Fonctions" "Liste des fonctions ARexx" @TOC "Macros" @{"ABS " LINK ABS} valeur absolue d'un nombre @{"ASC " LINK ASC} code ASCII d'un caractère @{"ASK " LINK ASK} saisie d'une chaîne au clavier @{"ASKNUM " LINK ASKNUM} saisie d'un nombre au clavier @{"ASKTEXT " LINK ASKTEXT} saisie d'une chaîne de caractères au clavier @{"BEGLINE " LINK BEGLINE} déplacement du curseur sur le premier caractère de la ligne @{"BLOCK " LINK BLOCK} renvoie le numéro de colonne ou de ligne du bloc marqué @{"CALL " LINK CALL} appel d'un script ARexx @{"CATLINES" LINK CATLINES} regroupement de deux lignes de texte @{"CHR " LINK CHR} renvoie le caractère possédant le code ASCII spécifié @{"CLIPUNIT" LINK CLIPUNIT} choix de l'unité du presse-papiers (clipboard.device) @{"CLOSE " LINK CLOSE} ferme la fenêtre texte spécifiée @{"COL " LINK COL} numéro de colonne où est situé le curseur @{"COPY " LINK COPY} copie d'un texte dans une unité du presse-papiers @{"CUTLINE " LINK CUTLINE} coupure de la ligne de texte @{"DATE " LINK DATE} renvoie la date actuelle @{"DAYS " LINK DAYS} comparaison de deux dates @{"DEF " LINK DEF} définition d'une nouvelle fonction @{"DELBEGIN" LINK DELBEGIN} effacement du début de la ligne @{"DELCHARS" LINK DELCHARS} effacement de caractères @{"DELEND " LINK DELEND} effacement de la fin de la ligne @{"DELLEFT " LINK DELLEFT} effacement des mots à gauche du curseur @{"DELPREV " LINK DELPREV} effacement des caractères précédant le curseur @{"DELRIGHT" LINK DELRIGHT} effacement du mot à droite du curseur @{"ENDLINE " LINK ENDLINE} déplacement du curseur à la fin de la ligne @{"EXEC " LINK EXEC} interprétation d'une chaîne de caractères @{"FILENAME" LINK FILENAME} nom du fichier complet @{"FILEPART" LINK FILEPART} nom du fichier @{"FILEPATH" LINK FILEPATH} chemin du fichier @{"FIND " LINK FIND} recherche de texte @{"FONTNAME" LINK FONTNAME} renvoie le nom de la fonte de caractères utilisée @{"FONTSIZE" LINK FONTSIZE} renvoie la taille de la fonte de caractères utilisée @{"FOR " LINK FOR} traitement d'une boucle @{"GOTO " LINK GOTO} déplacement du curseur @{"HELP " LINK "HELP"} affichage d'une aide AmigaGuide @{"IF " LINK "IF"} test @{"INIT " LINK "INIT"} initialisation de variables @{"INSLINES" LINK "INSLINES"} insertion de lignes vides @{"INSTEXT " LINK "INSTEXT"} insertion du texte spécifié @{"LEN " LINK "LEN"} longueur d'une chaîne de caractères @{"LINE " LINK "LINE"} numéro de ligne où est situé le curseur @{"LOAD " LINK "LOAD"} chargement d'un texte @{"LOADPREF" LINK "LOADPREF"} chargement d'un fichier de préférences @{"LOCK " LINK "LOCK"} verrouillage saisies utilisateur @{"LOWER " LINK "LOWER"} conversion d'un texte en minuscules @{"MACRO " LINK "MACRO"} appel d'une séquence programmée @{"MAP " LINK "MAP"} programmation d'une macro clavier @{"MARK " LINK "MARK"} marquage d'un bloc de texte @{"MENU " LINK "MENU"} exécution d'un menu @{"MESSAGE " LINK "MESSAGE"} affichage d'un message @{"MESURE " LINK "MESURE"} renvoie une dimension de la fenêtre @{"MODEDIT " LINK "MODEDIT"} fixe le mode insertion/surimpression @{"MODIF " LINK "MODIF"} test modification texte @{"NBLINES " LINK "NBLINES"} nombre de lignes du texte @{"NBTEXT " LINK "NBTEXT"} nombre de textes présents en mémoire @{"NEW " LINK "NEW"} ouverture d'une nouvelle fenêtre @{"OPEN " LINK "OPEN"} ouverture de texte(s) @{"PASTE " LINK "PASTE"} collage du contenu d'une unité du presse-papiers @{"PICKCOL " LINK "PICKCOL"} sélection d'une colonne de texte à l'aide de la souris @{"PICKLINE" LINK "PICKLINE"} sélection d'une ligne de texte à l'aide de la souris @{"POS " LINK POS} position d'une chaîne de caractères @{"PREFPATH" LINK PREFPATH} lecture/modification du chemin situant les fichiers de configuration @{"PRINT " LINK "PRINT"} impression texte @{"READCHAR" LINK "READCHAR"} lecture des caractères courants @{"READDEF " LINK "READDEF"} lecture de la définition d'une fonction @{"READLINE" LINK "READLINE"} lecture de la ligne spécifiée @{"READMAP " LINK "READMAP"} lecture d'une macro clavier @{"REPLACE " LINK "REPLACE"} remplacement d'un texte @{"REQFILE " LINK "REQFILE"} choix d'un fichier @{"REQLIST " LINK REQLIST} choix d'un élément dans une liste @{"REQTEXT " LINK REQTEXT} choix d'un texte @{"REQUEST " LINK "REQUEST"} affichage d'un message, choix OUI/NON @{"RESET " LINK "RESET"} réinitialisation de variables @{"REXXPATH" LINK REXXPATH} lecture/modification du chemin situant les scripts ARexx @{"SAVE " LINK "SAVE"} sauvegarde d'un texte @{"SAVBLOCK" LINK "SAVBLOCK"} sauvegarde du bloc de texte marqué @{"SAVECOPY" LINK "SAVECOPY"} test/choix sauvegarde copie fichier texte @{"SAVEICON" LINK "SAVEICON"} test/choix sauvegarde avec création icône @{"SAVEPREF" LINK "SAVEPREF"} sauvegarde fichier préférences @{"SAVETABS" LINK "SAVETABS"} test/choix sauvegarde tabulations @{"SEARCH " LINK SEARCH} recherche de texte avec motifs #?[]() @{"SECURITY" LINK "SECURITY"} détermination d'un nombre de boucles maximum avant débordement @{"SELECT " LINK "SELECT"} choix d'une option parmi plusieurs @{"SELFILE " LINK "SELFILE"} sélection du texte @{"SELTEXT " LINK "SELTEXT"} sélection d'un texte @{"SETFIND " LINK "SETFIND"} choix de la chaîne à rechercher @{"SETREP " LINK "SETREP"} choix de la chaîne de remplacement @{"SETFONT " LINK "SETFONT"} choix d'une fonte de caractères @{"SETTABS " LINK "SETTABS"} nombre de caractères associés à une tabulation @{"SGN " LINK "SGN"} test du signe d'un nombre @{"SORT " LINK "SORT"} tri de lignes de texte @{"STR " LINK "STR"} conversion d'un nombre en chaîne de caractères (décimal) @{"STRBIN " LINK "STRBIN"} conversion d'un nombre en chaîne de caractères (binaire) @{"STRHEX " LINK "STRHEX"} conversion d'un nombre en chaîne de caractères (hexadécimal) @{"SUBS " LINK "SUBS"} renvoie un sous-ensemble d'une chaîne de caractères @{"SUPBLOCK" LINK "SUPBLOCK"} effacement du bloc de texte @{"SUPLINES" LINK "SUPLINES"} suppression de lignes de texte @{"TESTCASE" LINK "TESTCASE"} mode de recherche (sensibilité aux majuscules/minuscules) @{"TEXTMARK" LINK "TEXTMARK"} renvoie le texte marqué @{"TIME " LINK "TIME"} renvoie l'heure courante @{"TITLE " LINK "TITLE"} choix du titre affiché dans la fenêtre @{"TOBACK " LINK "TOBACK"} renvoie la fenêtre active en arrière-plan @{"TOFRONT " LINK "TOFRONT"} renvoie la fenêtre active en avant-plan @{"TRACE " LINK "TRACE"} marquage d'un emplacement @{"TYPE " LINK "TYPE"} renvoie le type d'un caractère @{"UNLOCK " LINK "UNLOCK"} annule le verrouillage des actions utilisateur @{"UNMAP " LINK "UNMAP"} annulation d'une macro clavier @{"UNMARK " LINK "UNMARK"} annulation du marquage d'un texte @{"UPPER " LINK "UPPER"} conversion d'un texte en majuscules @{"VAL " LINK "VAL"} conversion d'une chaîne de caractères en nombre @{"VERSION " LINK "VERSION"} numéro de version du programme @{"WHILE " LINK "WHILE"} boucle tant_que... @{"WINDOW " LINK "WINDOW"} dimensionne la fenêtre texte @{"WLEFT " LINK "WLEFT"} déplacement d'un mot vers la gauche @{"WORD " LINK "WORD"} lecture du mot courant @{"WRIGHT " LINK "WRIGHT"} déplacement d'un mot vers la droite @{"WRITE " LINK "WRITE"} écriture d'un texte @{"WRITETAB" LINK "WRITETAB"} écriture tabulations @{"Index thématique" LINK "Index thématique"} @ENDNODE @NODE "Index thématique" "Classement thématique des fonctions ARexx" @TOC "Index thématique" @{" " LINK "Traitement chaînes"} Traitement des @{"chaînes de caractères" LINK "Chaînes de caractères"} @{" " LINK "Modification texte"} Édition, modification du texte @{" " LINK "Gestion blocs"} Fonctions portant sur des blocs de texte @{" " LINK "Déplacement curseur"} Gestion, déplacement du curseur @{" " LINK "RechercheRemplacement"} Recherche/Remplacement @{" " LINK "Maths"} Fonctions mathématiques @{" " LINK "Interactivité"} Fonctions interactives @{" " LINK "Gestion fenêtres"} Gestion des fenêtres @{" " LINK "Gestion préférences"} Gestion des préférences @{" " LINK "Divers"} Fonctions diverses @ENDNODE @NODE "Traitement chaînes" "Fonctions ARexx de traitement des chaînes de caractères" @TOC "Index thématique" @{"ASC " LINK "ASC"} code ASCII d'un caractère @{"CHR " LINK "CHR"} renvoie le caractère possédant le code ASCII spécifié @{"LEN " LINK "LEN"} longueur d'une chaîne de caractères @{"LOWER " LINK "LOWER"} conversion d'un texte en minuscules @{"POS " LINK "POS"} position d'une chaîne de caractères @{"STR " LINK "STR"} conversion d'un nombre en chaîne de caractères (décimal) @{"STRBIN " LINK "STRBIN"} conversion d'un nombre en chaîne de caractères (binaire) @{"STRHEX " LINK "STRHEX"} conversion d'un nombre en chaîne de caractères (hexadécimal) @{"SUBS " LINK "SUBS"} renvoie un sous-ensemble d'une chaîne de caractères @{"TYPE " LINK "TYPE"} renvoie le type d'un caractère @{"UPPER " LINK "UPPER"} conversion d'un texte en majuscules @{"VAL " LINK "VAL"} conversion d'une chaîne de caractères en nombre @ENDNODE @NODE "Modification texte" "Fonctions ARexx permettant l'édition du texte" @TOC "Index thématique" @{"CATLINES" LINK "CATLINES"} regroupement de deux lignes de texte @{"CUTLINE " LINK "CUTLINE"} coupure de la ligne de texte @{"DELBEGIN" LINK "DELBEGIN"} effacement du début de la ligne @{"DELCHARS" LINK "DELCHARS"} effacement de caractères @{"DELEND " LINK "DELEND"} effacement de la fin de la ligne @{"DELLEFT " LINK "DELLEFT"} effacement des mots à gauche du curseur @{"DELPREV " LINK "DELPREV"} effacement des caractères précédant le curseur @{"DELRIGHT" LINK "DELRIGHT"} effacement du mot à droite du curseur @{"INSLINES" LINK "INSLINES"} insertion de lignes vides @{"MODEDIT " LINK "MODEDIT"} fixe le mode insertion/surimpression @{"NBLINES " LINK "NBLINES"} nombre de lignes du texte @{"READCHAR" LINK "READCHAR"} lecture des caractères courants @{"READLINE" LINK "READLINE"} lecture de la ligne spécifiée @{"SETTABS " LINK "SETTABS"} nombre de caractères associés à une tabulation @{"SORT " LINK "SORT"} tri de lignes de texte @{"SUPLINES" LINK "SUPLINES"} suppression de lignes de texte @{"WORD " LINK "WORD"} lecture du mot courant @{"WRITE " LINK "WRITE"} écriture d'un texte @{"WRITETAB" LINK "WRITETAB"} écriture tabulations @ENDNODE @NODE "Gestion blocs" "Fonctions ARexx permettant de gérer les blocs de texte" @TOC "Index thématique" @{"BLOCK " LINK "BLOCK"} renvoie le numéro de colonne ou de ligne du bloc marqué @{"CLIPUNIT" LINK "CLIPUNIT"} choix de l'unité du presse-papiers (clipboard.device) @{"COPY " LINK "COPY"} copie d'un texte dans une unité du presse-papiers @{"MARK " LINK "MARK"} marquage d'un bloc de texte @{"PASTE " LINK "PASTE"} collage du contenu d'une unité du presse-papiers @{"SAVBLOCK" LINK "SAVBLOCK"} sauvegarde du bloc de texte marqué @{"SUPBLOCK" LINK "SUPBLOCK"} effacement du bloc de texte @{"TEXTMARK" LINK "TEXTMARK"} renvoie le texte marqué @{"UNMARK " LINK "UNMARK"} annulation du marquage d'un texte @ENDNODE @NODE "Déplacement curseur" "Fonctions ARexx permettant de gérer les déplacements du curseur" @TOC "Index thématique" @{"BEGLINE " LINK "BEGLINE"} déplacement du curseur sur le premier caractère de la ligne @{"ENDLINE " LINK "ENDLINE"} déplacement du curseur en fin de ligne @{"COL " LINK "COL"} numéro de colonne où est situé le curseur @{"GOTO " LINK "GOTO"} déplacement du curseur @{"LINE " LINK "LINE"} numéro de ligne où est situé le curseur @{"NBLINES " LINK "NBLINES"} nombre de lignes du texte @{"TRACE " LINK "TRACE"} marquage d'un emplacement @{"WLEFT " LINK "WLEFT"} déplacement d'un mot vers la gauche @{"WRIGHT " LINK "WRIGHT"} déplacement d'un mot vers la droite @ENDNODE @NODE "RechercheRemplacement" "Fonctions ARexx de gestion de la recherche et du remplacement de texte" @TOC "Index thématique" @{"FIND " LINK "FIND"} recherche de texte @{"REPLACE " LINK "REPLACE"} remplacement d'un texte @{"SEARCH " LINK SEARCH} recherche de texte avec motifs #?[]() @{"SETFIND " LINK "SETFIND"} choix de la chaîne à rechercher @{"SETREP " LINK "SETREP"} choix de la chaîne de remplacement @{"TESTCASE" LINK "TESTCASE"} mode de recherche (sensibilité aux majuscules/minuscules) @ENDNODE @NODE "Gestion préférences" "Fonctions ARexx de gestion des préférences" @TOC "Index thématique" @{"FONTNAME" LINK FONTNAME} nom de la fonte de caractères utilisée @{"FONTSIZE" LINK FONTSIZE} taille de la fonte de caractères utilisée @{"LOADPREF" LINK LOADPREF} chargement d'un fichier de préférences @{"PREFPATH" LINK PREFPATH} lecture/modification du chemin situant les fichiers de configuration @{"REXXPATH" LINK REXXPATH} lecture/modification du chemin situant les scripts ARexx @{"SAVECOPY" LINK SAVECOPY} test/choix sauvegarde copie fichier texte @{"SAVEICON" LINK SAVEICON} test/choix sauvegarde avec création icône @{"SAVEPREF" LINK SAVEPREF} sauvegarde fichier préférences @{"SAVETABS" LINK SAVETABS} test/choix sauvegarde tabulations @{"SETTABS " LINK SETTABS} nombre de caractères associés à une tabulation @{"SETFONT " LINK SETFONT} choix d'une fonte de caractères @ENDNODE @NODE "Maths" "Fonctions ARexx de calcul" @TOC "Index thématique" @{"ABS " LINK ABS} valeur absolue d'un nombre @{"FOR " LINK FOR} traitement d'une boucle @{"IF " LINK IF} test @{"INIT " LINK INIT} initialisation de variables @{"RESET " LINK RESET} réinitialisation de variables @{"SECURITY" LINK SECURITY} nombre de boucles maximum avant débordement @{"SGN " LINK SGN} test du signe d'un nombre @{"STR " LINK STR} conversion d'un nombre en chaîne de caractères (décimal) @{"VAL " LINK VAL} conversion d'une chaîne de caractères en nombre @{"WHILE " LINK WHILE} boucle tant_que... @ENDNODE @NODE "Interactivité" "Fonctions ARexx permettant le dialogue avec l'utilisateur" @TOC "Index thématique" @{"ASK " LINK ASK} saisie d'une chaîne au clavier @{"ASKNUM " LINK ASKNUM} saisie d'un nombre au clavier @{"ASKTEXT " LINK ASKTEXT} saisie d'une chaîne de caractères au clavier @{"LOCK " LINK "LOCK"} verrouillage saisies utilisateur @{"MESSAGE " LINK "MESSAGE"} affichage d'un message @{"PICKCOL " LINK "PICKCOL"} sélection d'une colonne de texte à l'aide de la souris @{"PICKLINE" LINK "PICKLINE"} sélection d'une ligne de texte à l'aide de la souris @{"REQFILE " LINK "REQFILE"} choix d'un fichier @{"REQTEXT " LINK "REQTEXT"} choix d'un texte @{"REQUEST " LINK "REQUEST"} affichage d'un message, choix OUI/NON @{"SELECT " LINK "SELECT"} choix d'une option parmi plusieurs @{"UNLOCK " LINK "UNLOCK"} annule le verrouillage des actions utilisateur @ENDNODE @NODE "Divers" "Fonctions ARexx diverses" @TOC "Index thématique" @{"CALL " LINK "CALL"} appel d'un script ARexx @{"DATE " LINK "DATE"} renvoie la date actuelle @{"DAYS " LINK "DAYS"} comparaison de deux dates @{"DEF " LINK "DEF"} définition d'une nouvelle fonction @{"EXEC " LINK "EXEC"} interprétation d'une chaîne de caractères @{"HELP " LINK "HELP"} affichage d'une aide AmigaGuide @{"MACRO " LINK "MACRO"} appel d'une séquence programmée @{"MAP " LINK "MAP"} programmation d'une macro clavier @{"MENU " LINK "MENU"} exécution d'un menu @{"READDEF " LINK "READDEF"} lecture de la définition d'une fonction @{"READMAP " LINK "READMAP"} lecture d'une macro clavier @{"TIME " LINK "TIME"} renvoie l'heure courante @{"UNMAP " LINK "UNMAP"} annulation d'une macro clavier @{"VERSION " LINK "VERSION"} numéro de version du programme @ENDNODE @NODE "Gestion fenêtres" "Fonctions ARexx de gestion des fenêtres" @TOC "Index thématique" @{"CLOSE " LINK CLOSE} ferme la fenêtre texte spécifiée @{"FILENAME" LINK FILENAME} nom du fichier complet @{"FILEPART" LINK FILEPART} nom du fichier @{"FILEPATH" LINK FILEPATH} chemin du fichier @{"FONTNAME" LINK FONTNAME} nom de la fonte de caractères utilisée @{"FONTSIZE" LINK FONTSIZE} taille de la fonte de caractères utilisée @{"INSTEXT " LINK INSTEXT} insertion du texte spécifié @{"LOAD " LINK LOAD} chargement d'un texte @{"MESURE " LINK MESURE} renvoie une dimension de la fenêtre @{"MODIF " LINK MODIF} test modification texte @{"NBTEXT " LINK NBTEXT} nombre de textes présents en mémoire @{"NEW " LINK NEW} ouverture d'une nouvelle fenêtre @{"OPEN " LINK OPEN} ouverture de texte(s) @{"PRINT " LINK PRINT} impression texte @{"REQLIST " LINK REQLIST} choix d'un élément dans une liste @{"REQTEXT " LINK REQTEXT} choix d'un texte @{"SAVE " LINK "SAVE"} sauvegarde d'un texte @{"SELFILE " LINK "SELFILE"} sélection du texte @{"SELTEXT " LINK "SELTEXT"} sélection d'un texte @{"SETFONT " LINK "SETFONT"} choix d'une fonte de caractères @{"TITLE " LINK "TITLE"} choix du titre affiché dans la fenêtre @{"TOBACK " LINK "TOBACK"} renvoie la fenêtre active en arrière-plan @{"TOFRONT " LINK "TOFRONT"} renvoie la fenêtre active en avant-plan @{"WINDOW " LINK "WINDOW"} dimensionne la fenêtre texte @ENDNODE @NODE "DEF" "Fonction ARexx DEF" @TOC "Fonctions" Vous pouvez définir un nombre quelconque de fonctions utilisant des fonctions internes ainsi que n'importe quel opérateur. Une de ces fonctions peut même faire appel à une autre fonction précédemment définie. Les arguments peuvent être d'un type quelconque, il doivent simplement correspondre aux types attendus par les fonctions qui seront appelées ou être compatibles avec les opérateurs utilisés. Il ne peut y avoir plus d'une déclaration dans une même ligne. La forme de ces définitions est de la forme suivante: DEF nom_fonction(argument,...) = définition des opérations. Le mot clé DEF doit impérativement commencer la définition, sans aucun espace préalable. Le nom des fonctions peut comprendre de 1 à 13 caractères alphanumériques, y compris les lettres accentuées et le soulignement (_). Le premier caractère doit cependant toujours être une lettre. Les fonctions internes ne peuvent être redéfinies. Le nombre des arguments est limité à 15 au maximum. Ce nombre est fixe pour une définition donnée (vous ne pouvez pas déclarer de fonction possédant un nombre variable d'arguments). Il doit y avoir au moins un argument dans la définition, mais celui-ci peut ne pas être utilisé. Les arguments doivent bien entendu posséder des noms distincts. Exemples: Création d'un patronyme complet DEF PATRONYME(NOM,PRENOM) = UPPER(NOM)+" "+PRENOM La redéfinition d'une fonction ayant déjà été définie est possible, la nouvelle définition remplace alors l'ancienne. Ceci peut être utile lorsque vous essayez de définir une fonction complexe, plusieurs essais pouvant alors être utiles... Voir aussi : @{"READDEF" LINK "READDEF"}, @{"STARTUP" LINK STARTUP}. @ENDNODE @NODE "ABS" "Fonction ARexx ABS" @TOC "Maths" ABS(nombre) Cette fonction renvoie la valeur absolue du nombre donné en argument. Le nombre peut appartenir à une @{"variable" LINK "Variable"}. Exemples: ABS(-8) renvoie 8 ABS(4) renvoie 4 ABS(N) renvoie la valeur absolue du nombre N Rappel: les nombres doivent être du type entier. @ENDNODE @NODE "ASC" "Fonction ARexx ASC" @TOC "Fonctions" ASC(texte,rang) Cette fonction renvoie le code ASCII du caractère appartenant à la chaîne de texte passée en argument, du rang spécifié. Le rang doit être compris entre 1 et la longueur de la chaîne passée en argument. Exemples: ASC("essai",1) renvoie 101 (code ASCII du caractère e) ASC(TEXTE,LEN(TEXTE)) renvoie le code ASCII du dernier caractère de la @{"variable" LINK "Variable"} TEXTE. Voir aussi: @{"CHR" LINK "CHR"} @ENDNODE @NODE ASK "Fonction obsolète" @TOC Interactivité ASK("titre") Cette fonction a été supprimée dans la version 1.5 Utilisez en place l'unes des fonctions @{"ASKNUM" LINK ASKNUM} ou @{"ASKTEXT" LINK ASKTEXT}. Si vous désirez utiliser d'anciens scripts utilisant cette fonction, utilisez la @{"définition" LINK DEF} suivante: DEF ASK(T)=ASKTEXT(T,"") @ENDNODE @NODE ASKNUM "Fonction ARexx ASKNUM" @TOC Interactivité ASKNUM("titre",nombre) Version 1.5 Ouvre une boîte de requête permmettant la saisie d'un nombre. Le second argument est utilisé pour initialiser cette demande. Si l'utilisateur clique sur Annule, une chaîne nulle est renvoyée, sinon une chaîne correspondant au nombre saisi est renvoyée. Seuls des nombres entiers peuvent être saisis. Voir aussi: @{"ASKTEXT" LINK ASKTEXT}. @ENDNODE @NODE "ASKTEXT" "Fonction ARexx ASKTEXT" @TOC "Interactivité" ASKTEXT("texte","chaîne") Ouvre une requête contenant le texte spécifié. La boîte de requête contient une boîte de texte dans laquelle l'utilisateur peut saisir une chaîne de caractères. Le texte saisi est renvoyé comme résultat si l'utilisateur clique sur le bouton Valide, sinon une chaîne nulle est renvoyée (clic sur le bouton Annule). Le texte affiché en titre peut contenir de une à treize lignes séparées par des sauts de lignes. Exemple: ASKTEXT("Entrez le premier"+CHR(10)+"mot puis frappez"+CHR(10)+"sur ENTREE") Voir aussi: @{"ASKNUM" LINK ASKNUM} @ENDNODE @NODE "BEGLINE" "Fonction ARexx BEGLINE" @TOC "Déplacement curseur" BEGLINE(ligne) Déplace le curseur sur le premier caractère de la ligne spécifiée. À noter que le numéro de la première ligne est le 1. La ligne courante, où est située le curseur, est désignée par la fonction @{"LINE" LINK "LINE"}, le nombre total de lignes du texte courant est donné par la fonction @{"NBLINES" LINK "NBLINES"}. Cette fonction renvoie le numéro de colonne où se place le curseur. Exemple: BEGLINE(LINE) déplacement sur le premier caractère de la ligne courante BEGLINE(10) déplacement sur le premier caractère de la dixième ligne @ENDNODE @NODE "BLOCK" "Fonction ARexx BLOCK" @TOC "Gestion blocs" BLOCK(indice) Cette fonction sert à déterminer les coordonnées du début et de la fin de la zone de texte marquée (sélectionnée). La valeur renvoyée est nulle si aucun texte n'est sélectionné, sinon la valeur renvoyée dépend de l'argument: - elle correspond au numéro de colonne de début si l'argument vaut 0, - elle correspond au numéro de ligne de début si l'argument vaut 1, - elle correspond au numéro de colonne de fin si l'argument vaut 2, - elle correspond au numéro de ligne de fin si l'argument vaut 3. Toute autre valeur de l'argument entraîne un message d'erreur. Exemple: 'BLOCK(0)' if result=0 then do 'MESSAGE("Sélectionnez une zone"+CHR(10)+"de texte !")' exit end @ENDNODE @NODE "CALL" "Fonction ARexx CALL" @TOC "Divers" CALL(script, argument1, argument2...) Appel d'un script ARexx. Le nom du script, donné en argument, n'a pas à inclure l'extension ".amitex". Cette fonction n'est pas utile dans un script ARexx mais peut servir dans une @{"macro-commande" LINK "Direct mode"} (ALT-Fx ou macro locale). L'appel peut être fait en spécifiant de 0 à 15 arguments (@{"numériques" LINK "Nombres"} ou @{"chaînes de caractères" LINK "Chaînes de caractères"}). L'exécution du script se fait en asynchrone, c'est à dire que la main est rendue au programme appelant avant la fin de l'exécution du script. La valeur renvoyée est le nom du script (sans grand intérêt)... Exemples: 'CALL("editscript")' 'CALL("multiplier","1.5","15.25") @ENDNODE @NODE "CATLINES" "Fonction ARexx CATLINES" @TOC "Fonctions" CATLINES(ligne) Cette fonction permet de regrouper (concaténer) la ligne spécifiée et la ligne qui la suit. Le résultat de la fonction est égal à 1 si tout s'est bien passé, 0 sinon. À noter que le numéro de la première ligne est le 1. La ligne courante, où est située le curseur, est désignée par la variable LINE, le nombre total de lignes du texte courant est donné par la variable NBLINES. Exemples: CATLINES(1) regroupe les première et seconde lignes CATLINES(LINE) regroupe la ligne courante et la suivante @ENDNODE @NODE "CHR" "Fonction ARexx CHR" @TOC "Fonctions" CHR(code) Renvoie le caractère possédant le code ASCII spécifié. Utilisé pour obtenir un saut de ligne (CHR(10)) ou un caractère spécial non présent sur le clavier. Le code peut varier de 1 à 255 maxi. Voir aussi: @{"ASC" LINK ASC} @ENDNODE @NODE "CLIPUNIT" "Fonction ARexx CLIPUNIT" @TOC "Gestion blocs" CLIPUNIT(unité) Cette fonction permet de choisir l'unité du presse-papiers utilisé pour les opérations de couper/coller. L'unité de presse-papiers peut varier de 0 à 255, soit 256 tampons utilisables. L'unité de presse-papiers généralement utilisée est l'unité 0. Elle correspond au clipboard.device, géré par le système. La valeur renvoyée correspond au numéro de l'unité qui été utilisée AVANT l'appel à cette fonction. Si vous voulez connaître celui-ci sans en changer passez une valeur négative pour l'argument. Exemple de script: 'CLIPUNIT(1)' choix d'une nouvelle unité (numéro 1) clip=RESULT conserver le numéro de l'ancienne unité ... 'CLIPUNIT('clip')' remettre l'ancienne unité @ENDNODE @NODE "CLOSE" "Fonction ARexx CLOSE" @TOC "Gestion fenêtres" CLOSE(fenêtre) Cette fonction provoque la fermeture de la fenêtre d'indice spécifié. Chaque fenêtre possède un indice différent, en commençant par l'indice 0 ( voir @{"SELTEXT" LINK "SELTEXT"}). La valeur renvoyée correspond au nombre de fenêtres texte restant présentes en mémoire. Utilisez la commande @{"MENU" LINK "MENU"}("Quitter") pour fermer toutes les fenêtres et entraîner la fin du programme. Pour cacher une fenêtre, sans perdre son texte en mémoire, utilisez la commande MENU("Cacher"), pour la réduire à sa taille minimale, utilisez la commande MENU("Réduire"). @ENDNODE @NODE "COL" "Fonction ARexx COL" @TOC "Déplacement curseur" COL Cette fonction permet de connaître le numéro de colonne où est situé le curseur. Elle n'a besoin d'aucun paramètre. Exemple: GOTO(COL+1,LINE) ' déplacement d'un caractère vers la droite @ENDNODE @NODE "COPY" "Fonction ARexx COPY" @TOC "Gestion blocs" COPY(clip,chaîne) Cette fonction permet de recopier une chaîne de caractères dans l'unité du presse-papiers spécifiée. Le numéro de clip peut varier de 0 à 255. L'unité de clip utilisée pour les opérations de couper/coller n'est pas modifiée. Utilisez la fonction @{"PASTE" LINK "PASTE"} pour coller le texte ainsi collé ou choisissez cette unité comme unité par défaut (@{"CLIPUNIT" LINK "CLIPUNIT"}) puis utilisez le menu @{"Édition/Coller" LINK "Paste clip"}. La valeur renvoyée est égale à 0 si tout se passe normalement. @ENDNODE @NODE "CUTLINE" "Fonction ARexx CUTLINE" @TOC "Fonctions" CUTLINE(x) Provoque la coupure de la ligne à l'emplacement où est situé le curseur. Si l'argument est positif, la fin de la ligne est alignée sur le premier caractère de la ligne courante sinon elle est placée au début de la ligne. La valeur renvoyée est positive si tout se passe bien. @ENDNODE @NODE "DATE" "Fonction ARexx DATE" @TOC "Divers" DATE(jour) Renvoie la date courante. Si l'argument jour est différent de zéro, le jour de la semaine est inclus. Exemples: DATE(0) renvoie 26-Déc-96 DATE(1) renvoie Jeudi 26-Déc-96 Voir aussi: @{"DAYS" LINK "DAYS"}, @{"TIME" LINK "TIME"}. @ENDNODE @NODE "DAYS" "Fonction ARexx DAYS" @TOC "Divers" DAYS(date1,date2) Renvoie le nombre de jours séparant les deux dates. Si la première date est antérieure à la seconde la valeur renvoyée est positive, sinon elle est négative (ou nulle si les deux dates concordent). Le format de la date doit correspondre à celui obtenu par l'instruction @{"DATE(0)" LINK "DATE"}, c'est à dire que le jour de la semaine ne doit pas être inclus. Cependant vous pouvez spécifier un jour de la semaine, mais alors sans la date, ainsi DAYS ("Mercredi", "18-Sep-95") renvoie le nombre de jours séparant le dernier mercredi passé du 18 septembre 95. Vous pouvez également spécifier "hier" ou "aujourd'hui". À noter que les dates doivent être postérieures au 1er janvier 78. Ainsi la date suivante 20-oct-14, correspond au 20 octobre de l'année 2014. Voir aussi : @{"TIME" LINK "TIME"}. @ENDNODE @NODE "DELBEGIN" "Fonction ARexx DELBEGIN" @TOC "Fonctions" DELBEGIN(0) Efface le début de la ligne (de la colonne 1 à la colonne où se situe le curseur). La valeur de l'argument n'a aucune importance. Renvoie le numéro de la colonne où est situé le curseur à la fin de l'opération (normalement 1). @ENDNODE @NODE "DELCHARS" "Fonction ARexx DELCHARS" @TOC "Fonctions" DELCHARS(nombre_caractères) Effacement du nombre de caractères spécifié, à partir de l'emplacement du curseur. Si la fin de la ligne ne comprend plus de caractères, la ligne est jointe avec la ligne qui la suit. Renvoie le numéro de la colonne où est situé le curseur à la fin de l'opération (normalement inchangé). @ENDNODE @NODE "DELEND" "Fonction ARexx DELEND" @TOC "Fonctions" DELEND(0) Effacement de la fin de la ligne, à partir de l'emplacement du curseur. Renvoie le numéro de la colonne où est situé le curseur à la fin de l'opération (normalement inchangé). @ENDNODE @NODE "DELLEFT" "Fonction ARexx DELLEFT" @TOC "Fonctions" DELLEFT(nombre_mots) Effacement du nombre de mots situés à gauche du curseur. Attention, les caractères ne faisant pas partie d'un mot, comme les espaces, les signes de ponctuation, etc, sont comptés comme des mots. Si le curseur atteint la première colonne l'opération est interrompue. Renvoie le numéro de la colonne où est situé le curseur à la fin de l'opération. @ENDNODE @NODE "DELPREV" "Fonction ARexx DELPREV" @TOC "Fonctions" DELPREV(nombre_caractères) Effacement du nombre de caractères spécifiés, situés avant le curseur. Si le curseur atteint la première colonne, le curseur se déplace à la fin de la colonne précédente, et l'opération se poursuit. Renvoie le numéro de la colonne où est situé le curseur à la fin de l'opération. @ENDNODE @NODE "DELRIGHT" "Fonction ARexx DELRIGHT" @TOC "Fonctions" DELRIGHT(nombre_mots) Effacement du nombre de mots situés à droite du curseur. Attention, les caractères ne faisant pas partie d'un mot, comme les espaces, les signes de ponctuation, etc, sont comptés comme des mots. Si le curseur atteint la dernière colonne l'opération est interrompue. Renvoie le numéro de la colonne où est situé le curseur à la fin de l'opération. @ENDNODE @NODE "ENDLINE" "Fonction ARexx ENDLINE" @TOC "Déplacement curseur" ENDLINE(ligne) Déplacement du curseur à la fin de la ligne spécifiée. À noter que le numéro de la première ligne est le 1. La ligne courante, où est située le curseur, est désignée par la fonction @{"LINE" LINK "LINE"}, le nombre total de lignes du texte courant est donné par la fonction @{"NBLINES" LINK "NBLINES"}. Renvoie le numéro de la colonne où est situé le curseur à la fin de l'opération. Exemple: ENDLINE(LINE) déplacement à la fin de la ligne courante ENDLINE(NBLINES) déplacement à la fin du texte @ENDNODE @NODE "EXEC" "Fonction ARexx EXEC" @TOC "Divers" EXEC(chaîne de caractères) Demande l'interprétation et l'exécution de la chaîne de caractères passée en argument, comme s'il s'agissait d'une ligne de commande. Le résultat dépend naturellement du contenu de la chaîne passée en argument. Exemple: EXEC(READLINE(LINE)) interprète la ligne courante EXEC(READMAP("CTRL-)") exécute la séquence associée à la combinaison de touches CTRL-) @ENDNODE @NODE "FILENAME" "Fonction ARexx FILENAME" @TOC "Gestion fenêtres" FILENAME("nom") Renomme la fenêtre courante, avec le nom spécifié. Si une chaîne nulle ("") est passée en argument, cette fonction renvoie le nom de la fenêtre, y compris le chemin complet. Voir aussi: @{"FILEPART" LINK FILEPART}, @{"FILEPATH" LINK FILEPATH}. @ENDNODE @NODE "FILEPART" "Fonction ARexx FILEPART" @TOC "Gestion fenêtres" FILEPART("nom") Renomme la fenêtre courante, en conservant le chemin. Si une chaîne nulle ("") est passée en argument, cette fonction renvoie le nom de la fenêtre, sans le chemin complet. Exemple: Supposons que le fichier courant soit "RAM:sources/x.c" la fonction FILEPART("") renverrait x.c, alors que la fonction FILEPART("nn.c") renommerait le fichier "RAM:sources/nn.c". Voir aussi: @{"FILENAME" LINK FILENAME}, @{"FILEPATH" LINK FILEPATH}. @ENDNODE @NODE FILEPATH "Fonction ARexx FILEPATH" @TOC "Gestion fenêtres" FILEPATH("chemin") Renomme la fenêtre courante, en conservant le nom du fichier, mais en utilisant le nouveau chemin ("path"). Si une chaîne nulle ("") est passée en argument, cette fonction renvoie le chemin utilisé pour localiser le fichier. Voir aussi; @{"FILENAME" LINK FILENAME}, @{"FILEPART" LINK FILEPART}. @ENDNODE @NODE "FIND" "Fonction ARexx FIND" @TOC "RechercheRemplacement" FIND(occurences) Lance la recherche du texte (spécifié par SETFIND ou par le menu @{"Rechercher" LINK Set}). Si l'argument occurences est positif, la recherche s'effectue après l'emplacement du curseur, alors que si cet argument est négatif, la recherche s'effectue vers le début du texte. Dans les deux cas la recherche s'arrête quand le nombre d'occurences spécifié a été atteint. La valeur renvoyée est égale au nombre de fois où la recherche a abouti. @ENDNODE @NODE "FONTNAME" "Fonction ARexx FONTNAME" @TOC "Gestion préférences" FONTNAME(x) Renvoie le nom de la fonte utilisée dans la fenêtre courante. L'argument peut prendre n'importe quelle valeur. Utilisez de préférence l'argument @{"SELTEXT" LINK "SELTEXT"}(-1), en vue d'une compatibilité ultérieure. Exemple: FONTNAME(SELTEXT(-1)) renvoie topaz.font (par exemple) @ENDNODE @NODE "FONTSIZE" "Fonction ARexx FONTSIZE" @TOC "Gestion préférences" FONTSIZE(x) Renvoie la taille de la fonte utilisée dans la fenêtre courante. L'argument peut prendre n'importe quelle valeur. Utilisez de préférence l'argument @{"SELTEXT" LINK "SELTEXT"}(-1), en vue d'une compatibilité ultérieure. Exemple: FONTNAME(SELTEXT(-1)) renvoie 11 (par exemple) @ENDNODE @NODE "FOR" "Fonction ARexx FOR" @TOC "Maths" FOR(init,condition_fin,action1,...) cette fonction permet de définir des boucles. Le premier argument (init) est exécuté une seule fois, quand l'appel de la fonction vient d'être fait. Le second argument définit la condition de fin de boucle. Enfin le troisième argument ainsi que les arguments suivants s'ils existent sont évalués à chaque exécution de la boucle. Exemples: FOR (I=0, I<10, I=I+1) Dans cet exemple la @{"variable" LINK "Variable"} I est initialisée à la valeur 0, tant que cette valeur est inférieure à 10, on incrémente cette valeur. I va donc prendre successivement les valeurs 1 à 10. FOR (I=0, I<10, I=I+1, WRITE(STR(I))) Cette formule comprend une instruction supplémentaire permettant d'écrire la valeur de la variable I à l'emplacement du curseur. N=100:FOR (I=0:J=0, I<=N, J=J+I, I=I+1):J Cette formule permet de calculer la somme des 100 premiers nombres. Le résultat de la somme est renvoyé (:J à la fin). Remarque: une boucle bloquée peut être interrompue par deux moyens: soit par le nombre de boucles maximal (défini par la fonction @{"SECURITY" LINK "SECURITY"}, soit en appuyant simultanément sur les trois touches CTRL, ALT et ESC. @ENDNODE @NODE "GOTO" "Fonction ARexx GOTO" @TOC "Déplacement curseur" GOTO(colonne,ligne) Déplacement du curseur à l'emplacement spécifié. À noter que le numéro de la première ligne est le 1. La ligne courante, où est située le curseur, est désignée par la fonction @{"LINE" LINK "LINE"}, le nombre total de lignes du texte courant est donné par la fonction @{"NBLINES" LINK "NBLINES"}. La colonne courante est désignée par la fonction @{"COL" LINK "COL"}. Cette fonction renvoie le contenu de la ligne. Exemples: GOTO(COL,LINE-1) déplacement sur la ligne du dessus GOTO(1,NBLINES) déplacement sur la dernière ligne DEF DOWN(LIGNES)=GOTO(COL,LINE+LIGNES) DEF UP(LIGNES)=GOTO(COL,LINE-LIGNES) DEF RIGHT(COLONNES)=GOTO(COL+COLONNES,LINE) DEF LEFT(COLONNES)=GOTO(COL-COLONNES,LINE) Les quatre derniers exemples permettent de définir des fonctions permettant de déplacer le curseur de façon relative à son emplacement actuel. @ENDNODE @NODE "HELP" "Fonction ARexx HELP" @TOC "Divers" HELP(node) Cette fonction permet l'appel d'AmigaGuide, comme par le menu "Projet/Aide spécifique". L'argument doit être le nom d'un noeud (node) du fichier AmiTex.guide. Vous pouvez, en particulier, spécifier n'importe quel nom de fonction ou de menu (en anglais). Exemples: HELP("GOTO") HELP("Copy block") @ENDNODE @NODE "IF" "Fonction ARexx IF" @TOC "Maths" IF(x, a1, a2) Si x est différent de zéro, renvoie a1 sinon renvoie a2. Seul a1 OU a2 sera évalué, selon le résultat de x. À noter que les arguments a1 et a2 peuvent être de n'importe quel type, ils peuvent également faire appel à d'autres fonctions, y compris d'autres fonctions IF. Exemples: IF(A>B,A,B) renvoie la valeur maximale DEF MIN(A,B)=IF(A