history Commandes Internes Tcl

history - Manipule l'historique

history ?option? ?arg arg ...?

La commande history effectue une des opérations relatives aux commandes récemment exécutées et enregistrées dans un historique Chacune de ces commandes enregistrées est référencée comme un "évènement" Quand on specifie un évènement à la commande history, les formes suivantes peuvent être employées:

[1] Un nombre si positif, se réfère à l'évènement (tous les évènements sont numérotés en commençant à 1) Si le nombre est négatif, il désigne un évènement relatif à l'évènement courant (-1 se réfère à l'évènement précedent, -2 à celui avant -1, et ainsi de suite) L'évenement 0 se réfère à l'évenement courant.

[2] Une chaîne: désigne l'évènement le plus recent qui correspond à la chaîne. Un évènement est consideré correspondre à la chaîne soit si la chaîne est la même que le premier caractères de l'évènement, ou si la chaîne correspond à l'évènement dans le sens de la commande string match.

La commande history peut prendre chacune des formes suivantes:

history: Identique à history info, décrit ci-dessous.
history add command ?exec?: Ajoute l'argument command à l'historique comme nouvel évènement. Si exec est spécifié (ou abrégé) alors la commande est aussi exécutée et son résultat est renvoyé. Si exec n'est pas spécifié alors une chaîne vide est renvoyée comme résultat.
history change newValue ?event?: Remplace la valeur enregistrée pour un évènement avec newValue Event spécifie l'évènement à remplacer, et pointe par défaut sur l'évènement courant (pas l'évènement -1). Cette commande est conçue pour être utilisée dans les commandes qui implémentent les nouvelles formes de substitution d'historique et souhaitent remplacer l'évènement courant (qui appelle la substitution) avec la commande créée par la substitution La valeur de retour est une chaîne vide.
history clear: Efface l'historique. La limite courante est retenue. Les numéros d'évènement d'historique sont réinitialisés.
history event ?event?: Renvoie la valeur de l'évènement donnée par event Event est égal à –1 par défaut.
history info ?count?: Renvoie une chaîne formatée (et lisible) donnant les numéros et contenus d'évènement pour chacun des évènements dans l'historique excepté l'évènement courant. Si count est spécifié alors seulement les count évènements les plus recent sont renvoyés.
history keep ?count?: Cette commande peut être employée pour changer la taille de l'historique à count évènements. Initialement, 20 évènements sont retenus dans l'historique. Si count n'est pas spécifié, la limite courante est renvoyée.
history nextid: Renvoie le nombre de l'évènement suivant enregistré dans l'historique. Il est utile par exemple pour afficher le numéro d'évènement dans une ligne de commande.
history redo ?event?: Re-exécute la commande indiquée par event et retourne son résultat. Event est égal à –1 par défaut. Cette commande résulte en une révision de l'historique, voir ci-dessous pour les détails.

REVISION DE L'HISTORIQUE

Tcl avant la version 8.0 avait un mécanisme de révision de l'historique complexe. Le mécanisme courant est plus limité, et les anciennnes opérations substitute et words ont été enlevées. (Comme consolation, l'opération clear a été ajoutée.)

L'option redo rend plus simple la " révision de l'historique ". Quand cette option est appelée alors l'évènement le plus récent est modifié et remplacé par le résultat de la commande d'historique. Si vous voulez refaire un évènement sans modifier l'historique, alors utilisez l'opération event pour récupérer un évènement, et l'opération add pour l'ajouter à l'historique et l'exécuter