info      Commandes Internes Tcl


NOM

info - Retourne l'information concernant l'état de l'interpréteur Tcl

SYNTAXE

info option ?arg arg ...?

DESCRIPTION

Cette commande fournit des informations concernant les rouages de l'interpréteur Tcl. Les options légales (qui peuvent être abrégées) sont:
info args procname
Renvoie une liste contenant les noms des arguments de la fonction procname, dans l'ordre Procname doit être le nom d'une fonction de commande Tcl.

info body procname
Renvoie le corps de la fonction procname Procname doit être le nom d'une fonction Tcl .

info cmdcount
Renvoie un compte du nombre total de commandes qui ont été appelées dans cet interpréteur.

info commands ?pattern?
Si pattern n'est pas spécifié, retourne une liste de noms de toutes les commandes Tcl dans le namespace courant, incluant à la fois les commandes interne écrites en C et les fonction de commandes définies en utilisant la commande proc. Si pattern est spécifié, seulement les noms correspondants à pattern sont renvoyés. A correspondance est déterminée en utilisant les même règles que pour string match. pattern peut être un nom qualifié comme Foo::print*. Ainsi, il peut spécifier un namespace particulier en utilisant une séquence de noms de namespace séparés par ::, et peut avoir un modèle correspondant à des caractères spéciaux à la fin pour spécifier un ensemble de commandes dans ce namespace. Si pattern est un nom qualifié, la liste résultante de noms de commande a chacun des noms qualifiés avec le nom du namespace spécifié .

info complete command
Renvoie 1 si command est une commande complète Tcl dans le sens où elle n'a pas de guillemets, accolades, crochets ou noms élément de tableau non fermants, Si la commande n'apparait pas complète alors 0 est renvoyé. Cette commande est typiquement utilisée dans les environnements orientés ligne de commande pour autoriser les utilisateurs à saisir des commandes réparties sur plusieurs lignes;  si la commande n'est pas complète, le script peut retarder l'évalualuation jusqu'a ce que des lignes supplémentaire ait été saisies pour compléter la commande. < info default procname arg varname
Procname doit être le nom d'une fonction de commande Tcl et arg doit être le nom d'un argument à cette fonction Si arg n'a pas de valeur par défaut alors la commande retourne 0. Autrement elle retourne 1 et place la valeur par défaut de arg dans la variable varname.

info exists varName
Renvoie 1 si le nom de variable varName existe dans le contexte courant (soit comme variable globale ou locale) et a été définie en lui donnant une valeur, retourne 0 autrement.

info globals ?pattern?
Si pattern n'est pas spécifié, retourne une liste de tout les noms des variables globales couramment définies. Les variables globales sont des variables dans le namespace global . Si pattern est spécifié, seulement les noms correspondants à pattern sont renvoyés La correspondance est déterminée en utilisant les même règles que pour string match.

info hostname
Renvoie le nom de l'ordinateur sur lequel cet appel est exécuté.

info level ?number?
Si number n'est pas spécifié, cette commande retourne un nombre donnant le niveau dans la pile de la fonction appelée, ou 0 si la commande est appelée au premier plan Si number est spécifié, alors le résultat est une liste consistant des noms et arguments de la fonction appellée au niveau number sur la pile Si number est positif alors il désigne un niveau de pile particulier (1 se réfère à la fonction active, 2 à la fonction qu'elle a appelé, et ainsi de suite); autrement cela donne un niveau relatif au niveau courant (0.htm se réfère à la fonction courante, -1.htm à l'appelant, et ainsi de suite). Voir la commande uplevel pour plus d'information sur la signification des niveaux de pile d'appel.

info library
Renvoie le nom du répertoire bibliothèque dans lequel les scripts Tcl standards sont stockés. Ceci est actuellement la valeur de la variable tcl_library et peut être changé en fixant tcl_library. Voir la page de manuel tclvars pour plus d'information.

info loaded ?interp?
Renvoie une liste décrivant tous les packages qui ont été chargés dans interp avec la commande load. Chaque élément de la liste est une sous-liste de deux éléments consistant du nom du fichier duquel le package a été chargé et du nom du package. Pour les packages statiquement chargés le nom de chemin sera une chaîne vide. Si interp est omis alors il'nformation est renvoyée pour tout packages chargé dans tout interpréteur du processus. Pour obtenir une liste des packages dans le courant interpréteur, Spécifiez une chaîne vide pour l'argument interp.

info locals ?pattern?
Si pattern n'est pas spécifié, retourne une liste de tout les noms des variables locales couramment-définies, incluant les arguments à la fonction courante, s'ils existent. Les variables définies avec les commandes global et upvar ne seront pas renvoyées. Si pattern est spécifié, seulement les noms correspondants à pattern sont renvoyés La correspondance est déterminée en utilisant les même règles que pour string match.

info nameofexecutable
Renvoie le nom de chemin complet du fichier binaire duquel l'application a été appelée. Si Tcl a été incapable d'identifier le fichier, alors une chaîne vide est renvoyée.

info patchlevel
Renvoie la valeur de la variable globale tcl_patchLevel; voyez la page de manuel tclvars pour plus d'information.

info procs ?pattern?
Si pattern n'est pas spécifié, retourne une liste de tout les noms des fonctions Tcl dans le namespace courant. Si pattern est spécifié, seulement les noms de fonction dans le namespace  courant correspondants à pattern sont renvoyés. La correspondance est déterminé en utilisant les même règles que pour string match.

info script
Si un fichier script Tcl est couramment évalué (ex. il y a un appel actif de Tcl_EvalFile ou il y a un appel actif de la commande source), alors cette commande retourne le nom du fichier traité Autrement la commande retourne une chaîne vide.

info sharedlibextension
Renvoie l'extension utilisée sur cette plateforme pour les noms des fichiers contenant des librairies partagées (par exemple, .so sous Solaris). Si les librairies partagées ne sont pas supportées sur cette plateforme alors une chaîne vide est renvoyée.

info tclversion
Renvoie la valeur de la variable globale tcl_version; voyez la page de manuel tclvars pour plus d'information.

info vars ?pattern?
Si pattern n'est pas spécifié, retourne une liste de tout les noms des variables (locales et globales incluses)couramment visibles. Si pattern est spécifié, seuls les noms correspondants à pattern sont renvoyés. La correspondance est déterminée en utilisant les même règles que pour string match. pattern peut être un nom qualifié comme Foo::option*. Ainsi, il peut spécifier un namespace particulier en utilisant une séquence de noms de namespace séparés par ::, et peut avoir modèle correspondant à des caractères spéciaux à la fin pour spécifier un ensemble de variables dans ce namespace. Si pattern est un nom qualifié, la liste résultante de noms de variable contient chaque variable namespace correspondante qualifiée avec le nom de son namespace

Dernière révision: 7.5


Index  Précédent  Suivant