| Objet : | Créer, modifier, supprimer ou afficher des fonctions de bibliothèque |
| Format : | LIBRARY [/= /D func /F [func] /N /P[n] /Q /R file ... /U] [command line] |
Utilisation :
LIBRARY charge, affiche et supprime les fonctions de bibliothèque, qui sont similaires aux fichiers batch, mais qui sont chargées dans la RAM et peuvent être appelées comme s'il s'agissait de commandes internes. Les fonctions de bibliothèque sont lues à partir de fichiers, avec la syntaxe suivante
nomfonction {
commande1
commande2
...
}
L'accolade ouvrante { doit se trouver sur la même ligne que le nom de la fonction (séparée par un espace), et l'accolade fermante } doit se trouver sur une ligne isolée.
Lorsque TCC démarre, il charge automatiquement tous les fichiers de fonctions de la bibliothèque qui se trouvent dans le sous-répertoire LIBRARY du répertoire d'installation de TCC du répertoire d'installation. Vous pouvez spécifier un autre emplacement en définissant la directive INI LibraryDirectory. Un fichier peut contenir un nombre illimité de fonctions.
Vous pouvez empêcher TCC de charger les fichiers de fonctions de la bibliothèque au démarrage avec l'option TCC /IL.
Si vous ne spécifiez aucun commutateur, LIBRARY affichera les noms des fonctions de bibliothèque qui correspondent aux arguments de la ligne de commande. Si vous ne spécifiez aucun argument, LIBRARY affichera tous les noms de fonctions de la bibliothèque.
La ligne de commande qui suit le nom de la fonction de bibliothèque est transmise à la fonction, et les arguments peuvent être référencés avec la mêmesyntaxe %1 - %n que celle utilisée par les fichiers batch et les alias.
Les fonctions de bibliothèque peuvent appeler des alias, des commandes internes ou externes, des fichiers batch ou d'autres fonctions de bibliothèque.
Vous pouvez spécifier la bibliothèque à utiliser pour un nom de fonction (ce qui vous permet d'utiliser les mêmes noms de fonction dans différentes bibliothèques). Pour spécifier une bibliothèque et une fonction particulières, utilisez la syntaxe suivante
bibliothèque$fonction
où bibliothèque est le nom du fichier de la bibliothèque et fonction le nom de la fonction.
Si vous n'indiquez pas de nom de bibliothèque, le système utilise le premier nom de fonction correspondant qu'il trouve, TCC utilisera le premier nom de fonction correspondant qu'il trouvera dans la liste des bibliothèques.
L'analyseur TCC recherchera un nom de fonction de bibliothèque correspondant avant de rechercher des plugins, des commandes internes, des commandes externes ou des fichiers batch. La ligne de commande qui suit le nom de la fonction de la bibliothèque est transmise à la fonction et les arguments peuvent être référencés avec la même syntaxe %1 - %n que celle utilisée pour les fichiers batch et les alias.
L'option de démarrage TCC empêche le chargement des fonctions de la bibliothèque par défaut (à partir du dossier Library).
Si le nom d'une commande est précédé d'un *, les correspondances entre les noms d'alias et de fonctions de bibliothèque seront ignorées.
Options :
| /F | Afficher les fonctions chargées (correspondantes) (le nom de la fonction peut contenir des caractères génériques) |
| /P[n] | Pauseaprès chaque page lors de l'affichage des fonctions. Les options disponibles à l'invite sont expliquées en détail dans la section Invites de page et de fichier. L'option /P a un argument facultatif n qui spécifie le nombre de secondes à attendre pour une frappe avant de continuer. |
| /R | Lire les fichiers de fonctions. Vous pouvez utiliser plusieurs fichiers avec une seule commande LIBRARY /R en plaçant les noms sur la ligne de commande, séparés par des espaces : |
library /r function1.lst function2.lst
| /U | Mettre à jour une fonction (sinon vous obtiendrez une erreur lors du chargement d'une fonction qui existe déjà) |