Commandes simples¶

Une commande simple est une suite d'affectations facultatives de variables, suivie de mots séparés par des blancs et de redirections, et terminée par un opérateur de contrôle. Le premier mot indique la commande à exécuter et est passé comme argument zéro. Les mots restants sont transmis comme arguments à la commande appelée.

La valeur renvoyée par une commande simple est son état final ou 128+n si la commande a été terminée par le signal n.

Conduites¶

Une conduite (« pipeline ») est une suite d'une ou plusieurs commandes séparées par un des opérateurs de contrôle | ou |&. Le format d'une conduite est :

La sortie standard de la commande_1 est connectée par un tube à l'entrée standard de la commande_2. Cette connexion est effectuée avant toute redirection indiquée par la commande elle-même (consultez REDIRECTIONS ci-dessous). Si |& est utilisé, la sortie d'erreur standard de la commande_1, en plus de sa sortie standard, est connectée à l'entrée standard de la commande_2 dans le tube ; c'est un raccourci pour 2>&1 |. Cette redirection implicite de la sortie d'erreur standard vers la sortie standard est réalisée après toute redirection précisée par la commande.

L'état renvoyé par une conduite est l'état final de la dernière commande, à moins que l'option pipefail soit activée. Si pipefail est activée, l'état renvoyé par la conduite est la valeur de la dernière commande (la plus à droite) à terminer avec un état différent de zéro ou zéro si toutes les commandes se terminent avec succès. Si le mot réservé ! précède une conduite, l'état final de cette conduite sera la négation logique de l'état final tel que décrit ci-dessus. L'interpréteur attend que toutes les commandes de la conduite soient terminées avant de renvoyer une valeur.

Si le mot réservé time précède une conduite, les temps passés par le programme en modes utilisateur et système sont indiqués quand la conduite se termine. L'option -p modifie le format de sortie pour celui indiqué par POSIX. Quand l'interpréteur est en mode posix, il ne reconnaît pas time comme un mot réservé si le lexème suivant commence par un « - ». La variable TIMEFORMAT peut contenir une chaîne de format indiquant comment les informations de chronométrage doivent être affichées ; consultez ci-dessous la description de TIMEFORMAT dans Variables de l'interpréteur.

Quand l'interpréteur est en mode posix, time peut être suivi d'un changement de ligne. Dans ce cas, l'interpréteur affiche le temps utilisateur et système total consommé par l'interpréteur et ses fils. La variable TIMEFORMAT peut être utilisée pour indiquer le format des informations de temps.

Chaque commande dans une conduite est exécutée comme un processus indépendant (c'est-à-dire dans un sous-interpréteur).

Listes¶

Une liste est une suite d'une ou plusieurs conduites séparées par l'un des opérateurs ;, &, && ou || et facultativement terminée par ;, & ou <changement de ligne>.

Dans cette liste d'opérateurs, && et || ont une priorité identique, suivis par ; et &, qui ont également une priorité identique.

Une suite d'un ou plusieurs changements de ligne peut apparaître dans une liste à la place d'un point-virgule pour délimiter les commandes.

Si une commande se termine par l'opérateur de contrôle &, l'interpréteur l'exécute en arrière-plan, dans un sous-interpréteur. L'interpréteur n'attend pas que la commande se termine et l'état renvoyé est 0. Les commandes séparées par un ; sont exécutées successivement, l'interpréteur attend que chaque commande se termine tour à tour. L'état renvoyé est l'état final de la dernière commande exécutée.

Les listes ET et OU sont des suites d'une ou plusieurs conduites séparées respectivement par les opérateurs de contrôle && et ||. Les listes ET et OU sont exécutées avec associativité à gauche. Une liste ET est de la forme

commande_2 est exécutée si, et seulement si, commande_1 renvoie un état final de zéro.

Une liste OU a la forme

commande_2 est exécutée si et seulement si commande_1 renvoie un état final différent de zéro. L'état renvoyé par des listes de ET et de OU est l'état final de la dernière commande exécutée dans la liste.

Commandes composées¶

Une commande composée est l'une des constructions suivantes. Dans la plupart des cas, une liste dans une description de commande pourrait être séparée du reste de la commande par un ou plusieurs changements de ligne, et pourrait être suivie d’un changement de ligne à la place d’un point-virgule.

(liste)

liste est exécutée dans un sous-interpréteur (consultez ENVIRONNEMENT D'EXÉCUTION DES COMMANDES ci-dessous). Les affectations de variables et les commandes internes qui affectent l'environnement de l'interpréteur n'ont pas d'effet une fois que la commande se termine. L'état renvoyé est l'état final de la liste.

{ liste; }

liste est simplement exécutée avec l'environnement de l'interpréteur en cours. liste doit se terminer par un changement de ligne ou un point-virgule. Cette construction est connue sous le nom de commandes groupées. L'état renvoyé est l'état final de la liste. Remarquez que contrairement aux métacaractères ( et ), { et } sont des mots réservés qui ne doivent apparaître que là où un mot réservé peut être reconnu. Puisqu'ils ne conduiront pas à un découpage en mots, ils doivent être séparés de la liste par un blanc ou un autre métacaractère de l'interpréteur.

((expression))

L'expression est évaluée selon les règles décrites ci-dessous dans ÉVALUATION ARITHMÉTIQUE. Si la valeur arithmétique de l'expression est différente de zéro, l'état renvoyé est 0 ; sinon l'état renvoyé est 1. C'est exactement équivalent à let "expression".

[[ expression ]]

Renvoie un état de 0 ou 1 selon l'évaluation de la condition expression. Les conditions sont composées de primitives décrites ci-dessous dans CONDITIONS. Le découpage en mots et le développement des chemins ne sont pas effectués sur les mots entre [[ et ]] ; le développement des tildes, des paramètres, des variables, le développement arithmétique, la substitution de commande et de processus, ainsi que la suppression des protections sont effectués. Les opérateurs conditionnels comme -f ne doivent pas être protégés afin d'être reconnus comme primitives.

Lorsqu'ils sont utilisés avec [[, les opérateurs < et > ordonnent d'un point de vue lexicographique en utilisant les paramètres linguistiques régionaux actuels.

Consultez la description de la commande interne test (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous) pour la gestion des paramètres (c'est-à-dire des paramètres manquants).

Quand les opérateurs == et != sont utilisés, la chaîne placée à droite de l'opérateur est considérée comme étant un motif dont la correspondance est recherchée selon les règles décrites ci-dessous dans Motifs génériques, comme si l’option extglob de l’interpréteur était activée. L’opérateur = est équivalent à ==. Si l'option d'interpréteur nocasematch est activée, la mise en correspondance est effectuée sans tenir compte de la casse (différence majuscule/minuscule) des caractères alphabétiques. La valeur renvoyée est 0 si les chaînes correspondent (==), ou ne correspondent pas (!=), au motif et 1 sinon. Toute partie du motif peut être protégée pour forcer la partie protégée à correspondre en tant que chaîne.

Un opérateur binaire supplémentaire, =~, est disponible, avec la même priorité que == et !=. Lorsqu'il est utilisé, la chaîne à droite de l'opérateur est considérée comme une expression rationnelle étendue et est mise en correspondance en conséquence (comme avec regex(3)). La valeur renvoyée est 0 si la chaîne correspond au motif et 1 si elle ne correspond pas. Si l'expression rationnelle n'est pas syntaxiquement correcte, la valeur renvoyée de l'expression conditionnelle est 2. Si l'option d'interpréteur nocasematch est activée, la mise en correspondance est effectuée sans tenir compte de la casse. Toute partie du motif peut être protégée pour forcer la partie protégée à correspondre en tant que chaîne. Les expressions entre crochets des expressions rationnelles doivent être traitées prudemment car les caractères de protection habituels perdent leur signification entre crochets. Si le motif est stocké dans une variable de l’interpréteur, la protection de développement de variable force le motif entier à correspondre en tant que chaîne. Les sous-chaînes mises en correspondance avec des sous-expressions entre parenthèses dans l'expression rationnelle sont sauvegardées dans la variable tableau BASH_REMATCH. L'élément d'indice 0 de BASH_REMATCH est la partie de la chaîne correspondant à l'expression rationnelle complète. L'élément d'indice n de BASH_REMATCH est la partie de la chaîne correspondant à la n-ième sous-expression entre parenthèses.

Les expressions peuvent être combinées en utilisant les opérateurs suivants, décrits par ordre de priorité décroissante :

for nom [ [ in [ mot ... ] ] ; ] do liste ; done

La liste de mots suivant in est développée, produisant une liste d'éléments. La variable nom prend tour à tour la valeur de chacun des éléments et liste est exécutée à chaque fois. Si in mot est omis, la commande for exécute la liste une fois pour chacun des paramètres positionnels existants (consultez PARAMÈTRES ci-dessous). L'état renvoyé est l'état final de la dernière commande exécutée. Si le développement des éléments suivant in conduit à une liste vide, aucune commande n'est exécutée et l'état renvoyé est 0.

for (( expr1 ; expr2 ; expr3 )) ; do liste ; done

L'expression arithmétique expr1 est d'abord évaluée selon les règles décrites ci-dessous sous ÉVALUATION ARITHMÉTIQUE. L'expression arithmétique expr2 est ensuite évaluée répétitivement jusqu'à valoir zéro. Chaque fois que expr2 est évaluée en une valeur différente de zéro, liste est exécutée et l'expression arithmétique expr3 est évaluée. Si l'une des expressions est omise, elle est considérée comme s'évaluant à 1. La valeur renvoyée est l'état final de la dernière commande dans liste qui est exécutée ou faux si l'une des expressions est incorrecte.

select nom [ in mot ] ; do liste ; done

La liste de mots à la suite de in est développée, produisant une liste d'éléments. L'ensemble des mots développés est imprimé sur la sortie d'erreur standard, chacun précédé par un nombre. Si in mot est omis, les paramètres positionnels sont imprimés (consultez PARAMÈTRES ci-dessous). L'invite PS3 est affichée et une ligne est lue depuis l'entrée standard. Si la ligne est constituée d'un nombre correspondant à l'un des mots affichés, alors ce mot est affecté à la valeur de la variable nom. Si la ligne est vide, les mots et l'invite sont affichés à nouveau. Si une fin de fichier (EOF) est lue, la commande se termine. Toute autre valeur lue force la variable nom à être définie à NULL. La ligne lue est conservée dans la variable REPLY. La liste est exécutée après chaque sélection, jusqu'à ce qu'une commande break soit atteinte. L'état final de select est l'état final de la dernière commande exécutée dans la liste ou zéro si aucune commande n'a été exécutée.

case mot in [ [(] motif [ | motif ] ... ) liste ;; ] ... esac

Une commande case commence d'abord par développer le mot, puis essaye de le mettre en correspondance tour à tour avec chacun des motifs en utilisant les mêmes règles que pour le développement des chemins (consultez ci-dessous Développement des chemins). Le mot est développé en utilisant le développement du tilde, le développement des paramètres et des variables, la substitution arithmétique, la substitution de commande, la substitution de processus et la suppression des protections. Chaque motif examiné est développé en utilisant le développement du tilde, le développement des paramètres et des variables, la substitution arithmétique, la substitution de commande et la substitution de processus. Si l'option d'interpréteur nocasematch est activée, la mise en correspondance est effectuée sans tenir compte de la casse des caractères alphabétiques. Quand une correspondance est trouvée, la liste associée est exécutée. Dès qu'un motif correct a été trouvé, il n'y a plus d'autre essai si l'opérateur ;; est utilisé. Si ;& est utilisé au lieu de ;;, l'exécution continue avec la liste associée au jeu de motifs suivant. Si ;;& est utilisé au lieu de ;;, l'interpréteur essaye la liste de motifs suivante, si elle existe, et exécute toute liste associée à un motif correspondant. L'état final est zéro si aucun motif ne correspond. Sinon il est l'état final de la dernière commande exécutée dans la liste.

if liste; then liste; [ elif liste; then liste; ] ... [ else liste; ] fi

La liste du if est exécutée. Si son état final est zéro, la liste du then est exécutée. Sinon, chacune des listes des elif est exécutée tour à tour et si son état final est zéro, la liste du then associé est exécutée et la commande termine. Sinon, la liste du else, si présente, est exécutée. L'état final est l'état final de la dernière commande exécutée ou zéro si aucune condition n'a été satisfaite.

while liste-1; do liste-2; done

until liste-1; do liste-2; done

La commande while répète la liste-2 tant que la dernière commande de la liste-1 renvoie un état final de zéro. La commande until est identique à la commande while, sauf que le test est inversé ; la liste-2 est exécutée tant que la dernière commande de la liste-1 renvoie un état final différent de zéro. L'état final des commandes while et until est l'état final de la dernière commande exécutée dans la liste-2 ou zéro si aucune commande n'a été exécutée.

Coprocessus¶

Un coprocessus est une commande d'interpréteur précédée par le mot réservé coproc. Un coprocessus est exécuté de façon asynchrone dans un sous-interpréteur, comme si la commande se terminait par l'opérateur de contrôle &, avec un tube bidirectionnel établi entre l'interpréteur d'exécution et le coprocessus.

Le format d'un coprocessus est :

Un coprocessus appelé NOM est créé. Si NOM n'est pas fourni, le nom par défaut est COPROC. NOM ne doit pas être fourni si commande est une commande simple (voir ci-dessus) ; sinon, il est interprété comme le premier mot d'une commande simple. Quand le coprocessus est exécuté, l'interpréteur crée une variable tableau (consultez Tableaux ci-dessous) appelée NOM dans le contexte de l'interpréteur d'exécution. La sortie standard de commande est connecté par un tube à un descripteur de fichier dans l'interpréteur d'exécution, et ce descripteur de fichier est affecté à NOM[0]. L'entrée standard de commande est connecté par un tube à un descripteur de fichier dans l'interpréteur d'exécution, et ce descripteur de fichier est affecté à NOM[1]. Ce tube est établi avant toute redirection indiquée par la commande (consultez REDIRECTIONS ci-dessous). Les descripteurs de fichier peuvent être utilisés comme arguments aux commandes d'interpréteur et redirections utilisant les développements standards de mot. Les descripteurs de fichier ne sont pas disponibles dans les sous-interpréteurs. L'identifiant du processus (PID) de l'interpréteur engendré pour exécuter le coprocessus est la valeur disponible de la variable NAME_PID. La commande interne wait peut être utilisée pour attendre que le coprocessus soit terminé.

Puisque le coprocessus est créé comme une commande asynchrone, la commande coproc se termine toujours avec succès. L'état renvoyé d'un coprocessus est l'état final de commande.

Définitions des fonctions de l'interpréteur¶

Une fonction de l'interpréteur est un objet qui est appelé comme une commande simple et qui exécute une commande composée avec un nouveau jeu de paramètres positionnels. Les fonctions de l'interpréteur sont déclarées de la façon suivante :

nom () commande-composée [redirection]

function nom [()] commande-composée [redirection]

Cela définit une fonction possédant le nom mentionné. Le mot réservé function est facultatif. S'il est fourni, les parenthèses sont facultatives. Le corps de la fonction est la commande composée commande-composée (consultez Commandes composées ci-dessus). Cette commande est généralement une liste de commandes entre { et }, mais peut être n'importe quelle commande décrite dans Commandes composées ci-dessus. La commande-composée est exécutée chaque fois que nom est indiqué comme le nom d'une commande normale. En mode posix, nom ne peut pas être le nom d’une des commandes internes spéciales de POSIX (« special builtins »). Toutes les redirections (consultez REDIRECTIONS ci-dessous) indiquées lorsqu'une fonction est définie sont effectuées lorsque la fonction est exécutée. L'état final d'une définition de fonction est zéro, à moins qu'une erreur de syntaxe ne se produise ou qu'une fonction en lecture seule n'existe déjà avec le même nom. Lorsque la fonction est exécutée, l'état final est celui de la dernière commande exécutée dans le corps de la fonction (consultez FONCTIONS ci-dessous).

Paramètres positionnels¶

Un paramètre positionnel est un paramètre noté par un ou plusieurs chiffres (à l'exception du chiffre 0 seul). Les paramètres positionnels sont affectés avec les arguments de l'interpréteur lors de son appel. Ils peuvent être réaffectés avec la commande interne set. On ne peut pas utiliser les affectations pour les paramètres positionnels. Ils sont temporairement remplacés lors de l'exécution d'une fonction de l'interpréteur (consultez FONCTIONS ci-dessous).

Un paramètre positionnel constitué de plusieurs chiffres doit être encadré par des accolades lors de son développement (consultez DÉVELOPPEMENTS ci-dessous).

Paramètres spéciaux¶

L'interpréteur traite plusieurs paramètres spécifiquement. Ces paramètres peuvent uniquement être consultés, il n'est pas permis de leur affecter une valeur.

*

Se développe en ensemble des paramètres positionnels, commençant par le premier. Quand le développement n’est pas entre guillemets doubles, tous les paramètres positionnels se développent en mots séparés. Dans les contextes où il sont réalisés, ces mots sont soumis à d’autres découpages de mot et développements de chemin. Quand le développement se produit entre des guillemets doubles, * se transforme en un seul mot constitué de la valeur de tous les paramètres positionnels séparés par le premier caractère de la variable spéciale IFS. C'est-à-dire que "$*" est équivalent à "$1c$2c...", où c est le premier caractère de la valeur de la variable IFS. Si IFS est inexistante, les paramètres sont séparés par des espaces. Si IFS est NULL, les paramètres sont accolés sans séparateurs.

@

Se développe en ensemble des paramètres positionnels, commençant par le premier. Quand le développement a lieu entre guillemets doubles, chaque paramètre se développe en un mot distinct. C'est-à-dire que "$@" est équivalent à "$1" "$2" .... Si le développement des guillemets doubles survient dans un mot, le développement du premier paramètre est accolé à la première partie du mot d'origine et le développement du dernier paramètre est accolé à la dernière partie du mot d'origine. Quand il n'y a pas de paramètres positionnels, "$@" et $@ ne se développent en rien (c'est-à-dire qu'ils sont simplement éliminés).

#

Correspond au nombre de paramètres positionnels, en base décimale.

?

Se développe en état final de la dernière conduite exécutée au premier plan.

-

Est remplacé par la liste des options de l'interpréteur indiquées durant l'appel, configurées avec la commande interne set ou celles créées par l'interpréteur lui-même (comme avec l'option -i).

$

Se transforme en PID de l'interpréteur. Dans un sous-interpréteur (), il se transforme en PID de l'interpréteur et non pas du sous-interpréteur.

!

Se transforme en PID de la dernière tâche placée en arrière-plan, soit exécutée comme une commande asynchrone, soit en utilisant la commande interne bg (consultez CONTRÔLE DES TÂCHES ci-dessous).

0

Se développe en nom de l'interpréteur ou du script. Ce paramètre est créé lors de l'initialisation de l'interpréteur. Si bash est appelé avec un fichier de commandes, $0 correspond au nom de ce fichier. Si bash est lancé avec l'option -c, alors $0 contient le premier argument, s'il y en a un, après la chaîne de commandes à exécuter. Sinon, ce paramètre contient le nom de fichier utilisé pour appeler bash, comme indiqué par l'argument zéro.

_

Au lancement de l'interpréteur, contient le chemin d'accès absolu utilisé pour appeler l'interpréteur, ou le script en cours d'exécution tel qu'il est passé dans l'environnement ou dans la liste des arguments. Devient le dernier argument de la commande précédente, après développement. Contient également le chemin d'accès complet de chaque commande exécutée et se retrouve dans l'environnement exporté à cette commande. Lors de la vérification de l'arrivée de courrier, contient le nom du fichier de courrier en cours de consultation.

Variables de l'interpréteur¶

Les variables suivantes sont créées par l'interpréteur :

BASH

Se développe en chemin d'accès complet à l'instance actuelle de bash.

BASHOPTS

Liste des options activées de l'interpréteur, séparées par des deux-points « : ». Chaque mot de la liste est un argument correct pour l'option -s de la commande interne shopt (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). Les options apparaissant dans BASHOPTS sont celles indiquées comme actives par shopt. Si cette variable est dans l'environnement au lancement de bash, chaque option de la liste est activée avant de lire les fichiers d’initialisation. Cette variable est en lecture seule.

BASHPID

Se transforme en PID de l'interpréteur bash actuel. Diffère de $$ sous certaines conditions, comme dans les sous-interpréteurs ne nécessitant pas que bash soit réinitialisé.

BASH_ALIASES

Une variable de type tableau associatif dont les éléments correspondent à une liste interne d'alias comme celle gérée par la commande interne alias. Les éléments ajoutés à ce tableau apparaissent dans la liste d'alias ; la destruction d'éléments du tableau implique le retrait des alias de la liste.

BASH_ARGC

Une variable de type tableau contenant le nombre de paramètres de chaque trame de la pile d'appel d'exécution de l'interpréteur bash actuel. Le nombre de paramètres du sous-programme actuel (fonction de l'interpréteur ou script exécuté par . ou source) est au sommet de la pile. Lorsqu'un sous-programme est exécuté, le nombre de paramètres passés est placé dans BASH_ARGC. L'interpréteur crée BASH_ARGC seulement dans le mode de traçage étendu (consultez ci-dessous la description de l'option extdebug de la commande interne shopt).

BASH_ARGV

Une variable de type tableau contenant tous les paramètres de la pile d'appel d'exécution de l'interpréteur bash actuel. Le dernier paramètre du dernier sous-programme est au sommet de la pile ; le premier paramètre de l'appel initial est en bas. Lorsqu'un sous-programme est exécuté, les paramètres fournis sont placés dans BASH_ARGV. BASH_ARGV est créé uniquement dans le mode de traçage étendu (consultez ci-dessous la description de l'option extdebug de la commande interne shopt).

BASH_CMDS

Une variable de type tableau associatif dont les éléments correspondent à une table de hachage interne de commandes comme celle gérée par la commande interne hash. Les éléments ajoutés à ce tableau apparaissent dans la liste table de hachage ; la destruction d'éléments du tableau implique le retrait des commandes de la table de hachage.

BASH_COMMAND

La commande en cours d'exécution ou sur le point d'être exécutée, à moins que l'interpréteur n'exécute une commande à la suite d'une capture, auquel cas c'est la commande s'exécutant au moment de la capture.

BASH_EXECUTION_STRING

L'argument commande de l'option d'appel -c.

BASH_LINENO

Une variable de type tableau dont les éléments sont les numéros de ligne des fichiers sources où chaque élément correspondant de FUNCNAME a été invoqué. ${BASH_LINENO[$i]} est le numéro de la ligne dans le fichier source (${BASH_SOURCE[$i+1]}) où ${FUNCNAME[$i]} a été appelé (ou ${BASH_LINENO[$i-1]} si consulté depuis une autre fonction de l'interpréteur). Utilisez LINENO pour obtenir le numéro de ligne actuel.

BASH_REMATCH

Une variable de type tableau dont les éléments sont affectés avec l'opérateur binaire =~ dans la commande conditionnelle [[. L'élément d'indice 0 est la partie de la chaîne correspondant à l'expression rationnelle complète. L'élément d'indice n est la partie de la chaîne correspondant à la n-ième sous-expression entre parenthèses. Cette variable est en lecture seule.

BASH_SOURCE

Une variable de type tableau dont les éléments sont les noms des fichiers source où les noms des fonctions d'interpréteur correspondants à la variable de type tableau FUNCNAME sont définis. La fonction d'interpréteur ${FUNCNAME[$i]} est définie dans le fichier ${BASH_SOURCE[$i]} et appelée depuis ${BASH_SOURCE[$i+1]}.

BASH_SUBSHELL

Incrémentée dans tous les sous-interpréteurs et environnements de sous-interpréteur quand l’interpréteur commence à s’exécuter dans cet environnement. La valeur initiale est 0.

BASH_VERSINFO

Une variable de type tableau protégée en écriture dont les éléments représentent la version de cette instance de bash. Cette valeur est affectée aux éléments du tableau comme suit :

BASH_VERSION

Se développe en une chaîne décrivant le numéro de version de cette instance de bash.

COMP_CWORD

Un indice dans ${COMP_WORDS} du mot contenant la position actuelle du curseur. Cette variable n'est disponible que dans les fonctions de l'interpréteur appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COMP_KEY

La touche (ou dernière touche d'une suite de touches) utilisée pour appeler la fonction de complètement actuelle.

COMP_LINE

La ligne de commande actuelle. Cette variable n'est disponible que dans les fonctions de l'interpréteur appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COMP_POINT

L'indice de la position actuelle du curseur relatif au début de la commande actuelle. Si la position actuelle du curseur est à la fin de la commande actuelle, la valeur de cette variable est égale à ${#COMP_LINE}. Cette variable n'est disponible que dans les fonctions de l'interpréteur et les commandes externes appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COMP_TYPE

Configurée à une valeur entière correspondant au type de complètement essayé qui a provoqué l'appel d'une fonction de complètement : TAB pour un complètement normal, ? pour l'affichage des complètements après tabulations successives, ! pour l'affichage des alternatives de complètement de mot partiel, @ pour afficher les complètements si le mot n'est pas modifié, ou % pour le menu de complètement. Cette variable n'est disponible que dans les fonctions de l'interpréteur et les commandes externes appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COMP_WORDBREAKS

Le jeu de caractères que la bibliothèque readline considère comme séparateurs de mots lors du complètement de mot. Si COMP_WORDBREAKS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

COMP_WORDS

Une variable de type tableau (consultez Tableaux ci-dessous) consistant en mots individuels de la ligne de commande actuelle. La ligne est découpée en mots comme readline la découperait, en utilisant COMP_WORDBREAKS tel que décrit ci-dessus. Cette variable n'est disponible que dans les fonctions de l'interpréteur appelées par les outils de complètement programmables (consultez Complètement programmable ci-dessous).

COPROC

Une variable de type tableau (consultez Tableaux ci-dessous) créée pour représenter les descripteurs de fichier pour les sorties depuis et les entrées vers un coprocessus non nommé (consultez Coprocessus ci-dessus).

DIRSTACK

Une variable de type tableau (consultez Tableaux ci-dessous) représentant le contenu actuel de la pile de répertoires. Les répertoires apparaissent dans la pile dans l'ordre dans lequel la commande interne dirs les affiche. Les affectations des éléments de cette variable tableau peuvent être utilisés pour modifier les répertoires déjà dans la pile, mais les commandes internes pushd et popd doivent être utilisées pour ajouter et enlever des répertoires. L'affectation de cette variable ne modifiera pas le répertoire actuel. Si DIRSTACK est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

EUID

Contient l'UID effectif de l'utilisateur, initialisé au démarrage de l'interpréteur. Cette variable est en lecture seule.

FUNCNAME

Une variable de type tableau contenant le nom de toutes les fonctions de l'interpréteur actuellement dans la pile d'appel d'exécution. L'élément d'indice 0 est le nom de l'une des fonctions en cours d'exécution dans l'interpréteur. L'élément le plus bas (celui avec l'indice le plus grand) est « main ». Cette variable n'existe que si une fonction de l'interpréteur est en cours d'exécution. Les affectations de FUNCNAME n'ont aucun effet et renvoient un état d'erreur. Si FUNCNAME est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

Cette variable peut être utilisée avec BASH_LINENO et BASH_SOURCE. Chaque élément de FUNCNAME a des éléments correspondant dans BASH_LINENO et BASH_SOURCE pour décrire la pile d'appel. Par exemple, ${FUNCNAME[$i]} a été appelé depuis le fichier ${BASH_SOURCE[$i+1]} à la ligne numéro ${BASH_LINENO[$i]}. La commande interne caller affiche la pile d'appel actuelle utilisant ces renseignements.

GROUPS

Une variable de type tableau contenant la liste des groupes dont l'utilisateur est membre. Les affectations de GROUPS n'ont aucun effet et renvoient un état d'erreur. Si GROUPS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

HISTCMD

Le numéro d'historique, ou l'indice dans la file d'historique, de la commande en cours. Si HISTCMD est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

HOSTNAME

Automatiquement configurée au nom de la machine actuelle.

HOSTTYPE

Automatiquement configurée en chaîne décrivant de façon unique le type de machine sur laquelle bash s'exécute. La valeur par défaut dépend du système.

LINENO

Chaque fois que ce paramètre est consulté, l'interpréteur le remplace par un nombre décimal représentant le numéro de la ligne actuelle (commençant à 1), au sein du script ou de la fonction. Hors d'un script ou d'une fonction, la valeur n'a pas nécessairement de sens. Si LINENO est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

MACHTYPE

Automatiquement configurée en chaîne décrivant le type du système sur lequel bash s'exécute, dans le format standard de GNU processeur-compagnie-système. La valeur par défaut dépend du système.

MAPFILE

Une variable de type tableau (consultez Tableaux ci-dessous) créée pour représenter le texte lu par la commande interne mapfile si aucun nom de variable n'a été fourni.

OLDPWD

Le répertoire de travail précédent tel que configuré par la commande cd.

OPTARG

La valeur du dernier argument d'option traité par la commande interne getopts (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

OPTIND

L'indice du prochain argument à traiter par la commande interne getopts (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

OSTYPE

Automatiquement configurée en chaîne décrivant le système d'exploitation sur lequel bash s'exécute. La valeur par défaut dépend du système.

PIPESTATUS

Une variable de type tableau (consultez Tableaux ci-dessous) contenant une liste des états finaux des processus exécutés dans la conduite exécutée la plus récemment au premier plan (qui peut éventuellement contenir une seule commande).

PPID

L'identifiant du processus parent de l'interpréteur. Cette variable est en lecture seule.

PWD

Le répertoire de travail actuel tel que configuré par la commande cd.

RANDOM

À chaque fois que ce paramètre est consulté, un entier aléatoire entre 0 et 32767 est engendré. Cette suite de nombres aléatoires peut être initialisée en affectant une valeur à RANDOM. Si RANDOM est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

READLINE_LINE

Le contenu du tampon de ligne readline, pour utiliser avec « bind -x » (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

READLINE_POINT

La position du point d'insertion dans le tampon de ligne readline, pour utiliser avec « bind -x » (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

REPLY

Configurée en ligne de saisie lue par la commande interne read lorsqu'aucun argument n'a été fourni.

SECONDS

À chaque fois que ce paramètre est consulté, le temps en seconde écoulé depuis le lancement de l'interpréteur est renvoyé. Si une valeur est affectée à SECONDS, la valeur renvoyée lors d’une consultation ultérieure est le temps en seconde écoulé depuis l'affectation, ajouté à la valeur affectée. Si SECONDS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

SHELLOPTS

Liste des options activées de l'interpréteur, séparées par des deux-points « : ». Chaque mot de la liste est un argument correct pour l'option -o de la commande interne set (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). Les options apparaissant dans SHELLOPTS sont celles indiquées comme actives par set -o. Si cette variable est dans l'environnement au lancement de bash, chaque option de la liste est activée avant de lire les fichiers d’initialisation. Cette variable est en lecture seule.

SHLVL

Incrémenté de 1 à chaque appel d'une instance de bash.

UID

Contient l'UID de l'utilisateur actuel, initialisé au démarrage de l'interpréteur. Cette variable est en lecture seule.

Les variables suivantes sont utilisées par l'interpréteur. Dans certains cas, bash affecte des valeurs par défaut aux variables ; ces cas sont décrits ci-dessous.

BASH_COMPAT

La valeur est utilisée pour définir le niveau de compatibilité de l’interpréteur. Consultez la description de la commande interne shopt ci-dessous dans COMMANDES INTERNES DE L'INTERPRÉTEUR pour une description des différents niveaux de compatibilité et leurs conséquences. La valeur peut être un nombre décimal (par exemple 4.2) ou entier (par exemple 42) correspondant au niveau de compatibilité voulu. Si BASH_COMPAT est détruite ou définie comme une chaîne vide, le niveau de compatibilité est défini à la valeur par défaut de la version actuelle. Si BASH_COMPAT est définie à une valeur de niveau de compatibilité impossible, l’interpréteur affiche un message d’erreur et définit le niveau de compatibilité à la valeur par défaut de la version actuelle. Les niveaux de compatibilité possibles correspondent aux options de compatibilité acceptée par la commande interne shopt décrite ci-dessous (par exemple, compat42 signifie que 4.2 et 42 sont des valeurs possibles). La version actuelle est aussi une valeur possible.

BASH_ENV

Si ce paramètre existe lorsque bash exécute un script, sa valeur est considérée comme un nom de fichier contenant les commandes d'initialisation de l'interpréteur, comme dans ~/.bashrc. La valeur de BASH_ENV est soumise au développement des paramètres, à la substitution de commande et au développement arithmétique avant d'être considérée comme un nom de fichier. PATH n'est pas utilisée pour rechercher le fichier obtenu.

BASH_XTRACEFD

Si configurée à une valeur entière correspondant à un descripteur de fichier correct, bash écrira la trace de sortie si set -x est activé vers ce descripteur de fichier. Le descripteur de fichier est fermé quand BASH_XTRACEFD est détruite ou qu'une nouvelle valeur lui est affectée. Détruire BASH_XTRACEFD ou lui affecter la chaîne vide conduit la trace de sortie à être envoyé vers la sortie d'erreur standard. Remarquez que configurer BASH_XTRACEFD à 2 (le descripteur de fichier de la sortie d'erreur standard) puis la détruire revient à fermer la sortie d'erreur standard.

CDPATH

Le chemin de recherche de la commande interne cd. Il s'agit d'une liste de répertoires, séparés par des deux-points « : », que l'interpréteur consulte lorsqu'il cherche un sous-répertoire destination de la commande cd. Un exemple de valeur est « .:~:/usr ».

CHILD_MAX

Définir le nombre de valeurs d’état de sortie des fils dont l’interpréteur doit se souvenir. Bash ne permettra pas à cette valeur d’être inférieure à un minimum imposé par POSIX, ni d’être supérieure à une valeur maximale (8192 pour l’instant). La valeur minimale dépend du système.

COLUMNS

Utilisée par la commande composée select pour déterminer la largeur du terminal lors de l'affichage des listes de sélection. Automatiquement configurée si l’option checkwinsize est activée ou dans un interpréteur interactif à la réception d'un signal SIGWINCH

COMPREPLY

Une variable de type tableau dans lequel bash lit les complètements possibles produits par une fonction de l'interpréteur appelée par les outils de complètement programmables (consultez Complètement programmable ci-dessous). Chaque élément du tableau contient un complètement possible.

EMACS

Si bash trouve cette variable dans l'environnement lorsque l'interpréteur démarre avec la valeur « t », il considère que l'interpréteur est lancé dans un tampon d'interpréteur d'Emacs et désactive l'édition en ligne.

ENV

Similaire à BASH_ENV. Utilisé quand l'interpréteur est invoqué en mode POSIX.

FCEDIT

L'éditeur par défaut utilisé par la commande interne fc.

FIGNORE

Une liste de suffixes, séparés par des deux-points « : », que bash ignorera lors du complètement des noms de fichiers (consultez READLINE ci-dessous). Un nom de fichier dont le suffixe correspond à l'un de ceux mentionnés dans FIGNORE est exclu de la liste des noms de fichiers correspondant pour le complètement. Par exemple, cette variable peut prendre la valeur « .o:~ » (des protections sont nécessaires pour l'affectation d'une valeur à cette variable qui contient des tildes).

FUNCNEST

Si configurée à une valeur numérique strictement positive, cela définit le niveau maximal d'imbrication de fonctions. Les invocations de fonctions qui dépassent ce niveau d'imbrication forceront la commande actuelle à abandonner.

GLOBIGNORE

Une liste de motifs séparés par des deux-points « : », définissant l'ensemble des noms de fichiers à ignorer lors du développement des chemins. Si un nom de fichier correspondant à un motif de développement des chemins correspond également à un motif dans GLOBIGNORE, il est supprimé de la liste des correspondances.

HISTCONTROL

Une liste de valeurs, séparées par des deux-points « : », commandant la façon dont les commandes sont sauvegardées dans la file d'historique. Si la liste des valeurs contient la valeur ignorespace, les lignes commençant par une espace ne sont pas sauvegardées dans la file d'historique. La valeur ignoredups conduit à ne pas sauvegarder une ligne correspondant exactement à la ligne de commande précédente. La présence de ignoreboth est un condensé pour ignorespace et ignoredups. La valeur erasedups conduit à retirer de la file d'historique toutes les lignes précédant la ligne actuelle et lui correspondant avant que cette ligne y soit sauvegardée. Toute valeur qui ne fait pas partie de la liste ci-dessus est ignorée. Si HISTCONTROL est inexistante ou si elle ne contient pas une valeur correcte, toutes les lignes lues par l'analyseur de l'interpréteur seront sauvegardées dans la file d'historique, selon la valeur de HISTIGNORE. La seconde ligne et les suivantes d'une commande multiligne ne sont pas testées et sont ajoutées dans l'historique indépendamment de la valeur de HISTCONTROL.

HISTFILE

Le nom du fichier dans lequel l'historique des commandes est sauvegardé (consultez HISTORIQUE ci-dessous). Par défaut, il s'agit de ~/.bash_history. Si inexistante, l'historique des commandes n'est pas sauvegardé lorsqu'un interpréteur se termine.

HISTFILESIZE

Le nombre maximal de lignes contenues dans le fichier d'historique. Quand cette variable contient une valeur, le fichier d’historique est tronqué, si besoin, pour ne pas contenir plus que ce nombre de lignes en enlevant les entrées les plus anciennes. Ce fichier est aussi tronqué à cette taille après son écriture quand un interpréteur se termine. Si la valeur est 0, le fichier d’historique est tronqué à une taille nulle. Les valeurs non numériques ou négatives empêchent la troncature. L’interpréteur définit la valeur par défaut à la valeur de HISTSIZE après avoir lu tous les fichiers d’initialisation.

HISTIGNORE

Une liste de motifs, séparés par des deux-points « : », déterminant quelles lignes de commande devraient être sauvegardées dans la file d'historique. Chaque motif est accroché au début de la ligne et doit lui correspondre en complètement (aucun ajout de « * » implicite). Chaque motif est comparé à chaque ligne après application des vérifications de HISTCONTROL. En plus des motifs génériques usuels de l'interpréteur, « & » correspond à la ligne précédente de l'historique. « & » peut être protégée par une contre-oblique ; la contre-oblique est supprimée avant de tenter une comparaison. La seconde ligne et les suivantes d'une commande multiligne ne sont pas testées et sont ajoutées dans l'historique quelque soit la valeur de HISTIGNORE.

HISTSIZE

Le nombre de commandes à mémoriser dans l'historique (consultez HISTORIQUE ci-dessous). Si la valeur est 0, les commandes ne sont pas sauvegardées dans la liste d’historique. Les valeurs négatives permettent de sauvegarder toutes les commandes dans la liste d’historique (sans limite). L’interpréteur définit la valeur par défaut à 500 après avoir lu tous les fichiers d’initialisation.

HISTTIMEFORMAT

Si cette variable existe et n'est pas NULL, sa valeur est utilisée comme une chaîne de caractères par strftime(3) afin d'imprimer l'horodatage associé à chaque élément de l'historique affiché par la commande interne history. Si cette variable existe, les horodatages sont écrits dans le fichier d'historique afin d'être conservés au fur et à mesure des sessions de l'interpréteur. Cela utilise le caractère de commentaire d'historique pour distinguer l'horodatage des autres lignes de l'historique.

HOME

Le répertoire d'accueil de l'utilisateur actuel ; l'argument par défaut de la commande interne cd. La valeur de cette variable est aussi utilisée lors du développement du tilde.

HOSTFILE

Contient le nom d'un fichier ayant le même format que /etc/hosts qui devra être lu lorsque l'interpréteur aura besoin de compléter un nom de machine. La liste des complètements possibles de noms de machines peut être changée pendant l'exécution de l'interpréteur ; à la tentative de complètement de nom de machine suivant le changement de valeur, bash ajoute le contenu du nouveau fichier à la liste existante. Si HOSTFILE existe mais est vide, ou désigne un fichier non accessible en lecture, bash essaie de lire /etc/hosts pour obtenir la liste des complètements de noms de machines possibles. Lorsque HOSTFILE est détruite, la liste des noms de machines est effacée.

IFS

Le séparateur de champs interne (« Internal Field Separator ») qui est utilisé pour le découpage en mots après les développements et pour découper les lignes en mots avec la commande interne read. La valeur par défaut est « <espace><tab><changement de ligne> ».

IGNOREEOF

Commande le comportement d'un interpréteur interactif à réception d'un caractère EOF (fin de fichier) comme unique saisie. Si elle existe, la valeur est le nombre de caractères EOF consécutifs qui doivent être tapés comme premiers caractères sur une ligne de saisie avant que bash ne termine. Si la variable existe mais que sa valeur n'est pas numérique ou si elle n'a pas de valeur, la valeur par défaut est 10. Si elle n'existe pas, EOF signifie la fin de la saisie pour l'interpréteur.

INPUTRC

Le nom du fichier d’initialisation pour readline, prioritaire sur le fichier par défaut ~/.inputrc (consultez READLINE ci-dessous).

LANG

Utilisée pour déterminer le paramètre linguistique régional pour toute catégorie non spécifiquement sélectionnée par une variable commençant par LC_.

LC_ALL

Cette variable surpasse LANG et toute autre variable LC_ indiquant une catégorie de paramètres linguistiques régionaux.

LC_COLLATE

Cette variable détermine l'ordre de collation utilisé pour trier les résultats du développement des chemins et détermine le comportement des expressions d’intervalle, des classes d'équivalences et des suites de collations dans le développement des chemins et la correspondance de motifs.

LC_CTYPE

Cette variable détermine l'interprétation des caractères et le comportement des classes de caractères lors du développement des chemins et de la recherche de correspondances de motifs.

LC_MESSAGES

Cette variable détermine le paramètre linguistique régional utilisé pour traduire les chaînes entre guillemets doubles précédées d'un $.

LC_NUMERIC

Cette variable détermine le paramètre linguistique régional utilisé pour formater les nombres.

LINES

Utilisée par la commande composée select pour déterminer la taille des colonnes lors de l'affichage des listes de sélection. Automatiquement configurée si l’option checkwinsize est activée ou dans un interpréteur interactif à la réception d'un signal SIGWINCH.

MAIL

Si ce paramètre correspond à un nom de fichier ou de répertoire et si la variable MAILPATH est inexistante, bash informe l'utilisateur de l'arrivée de messages dans le fichier indiqué ou le répertoire au format Maildir.

MAILCHECK

Indique la durée (en seconde) au bout de laquelle bash vérifie si un nouveau message est arrivé. La valeur par défaut est 60 secondes. Lorsque le délai est écoulé, l'interpréteur vérifiera la présence d'un courrier électronique avant d'afficher son invite de base. Si cette variable est inexistante, ou contient une valeur strictement négative, l'interpréteur désactive la vérification du courrier.

MAILPATH

Une liste de noms de fichiers séparés par des deux-points « : », dans lesquels on vérifiera l'arrivée de courrier. Le nom d'un fichier peut être suivi d'un point d'interrogation « ? », puis d'une chaîne de caractères indiquant le message à afficher en cas de courrier. Dans cette chaîne, le paramètre $_ correspond au nom du fichier de courrier actuel. Exemple :

OPTERR

Si configurée à la valeur 1, bash affiche les messages d'erreurs engendrés par la commande interne getopts (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). OPTERR est initialisée avec la valeur 1 à chaque appel de l'interpréteur ou au lancement d'un script.

PATH

Le chemin de recherche des commandes à exécuter. Il s'agit d'une liste de répertoires, séparés par des deux-points « : » dans lesquels l'interpréteur recherche les commandes (consultez EXÉCUTION DES COMMANDES ci-dessous). Un nom de répertoire de taille nulle (NULL) dans la valeur de PATH désigne le répertoire actuel. Un répertoire NULL peut apparaître comme deux deux-points consécutifs ou comme des deux-points en début ou en fin. Le chemin par défaut dépend du système et est choisi par l'administrateur installant bash. Une valeur commune est « /usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin ».

POSIXLY_CORRECT

Si cette variable existe dans l'environnement lorsque bash démarre, l'interpréteur passe en mode posix avant de lire les fichiers d’initialisation comme si l'option --posix avait été fournie. Si elle est créée pendant que l'interpréteur est en cours d'exécution, bash active le mode posix comme si la commande set -o posix avait été exécutée.

PROMPT_COMMAND

Si existante, sa valeur est exécutée comme commande préalablement à l'affichage de chaque invite de base.

PROMPT_DIRTRIM

Si elle contient un nombre supérieur à zéro, cette valeur est utilisée comme nombre de répertoires finaux à conserver lors du développement des protections de chaîne d'invite \w et \W (consultez INVITES ci-dessous). Les caractères supprimés sont remplacés par une ellipse.

PS1

La valeur de ce paramètre est développée puis utilisée comme chaîne d'invite de base (consultez INVITES ci-dessous). La valeur par défaut est « \s-\v\$  ».

PS2

La valeur de ce paramètre est développée comme PS1 puis utilisée comme chaîne d'invite secondaire. La valeur par défaut est « >  ».

PS3

La valeur de ce paramètre est utilisée comme invite de la commande select (consultez GRAMMAIRE DE L'INTERPRÉTEUR ci-dessus).

PS4

La valeur de ce paramètre est développée comme PS1 puis affichée entre chaque commande lors d'un suivi d'exécution. Le premier caractère de PS4 est répété autant de fois que nécessaire pour indiquer le niveau d'imbrication. La valeur par défaut est « +  ».

SHELL

Le chemin d'accès complet à l'interpréteur de commandes est conservé dans cette variable d'environnement. Si inexistante au démarrage de l'interpréteur, bash lui affecte le chemin d'accès complet à l'interpréteur de commandes de connexion de l'utilisateur actuel.

TIMEFORMAT

La valeur de ce paramètre est utilisée en tant que chaîne de format indiquant comment les informations de paramétrage doivent être affichées pour les conduites précédées du mot réservé time. Le caractère % introduit une suite de caractères de protection qui est développée en valeur de temps ou autre information. Les suites de caractères de protection et leurs significations sont les suivantes ; les crochets marquent les parties facultatives.

Le p facultatif est un chiffre indiquant la précision, le nombre de chiffres après la virgule. Une valeur de 0 conduit à affichage de nombre entiers. Trois chiffres au plus peuvent être affichés après la virgule ; toute valeur supérieure à 3 sera modifiée en 3. Si p n'est pas précisé, la valeur 3 est utilisée.

Le l facultatif indique un format plus long, incluant les minutes, de la forme MMmSS.DDs. La valeur de p détermine si la partie décimale est affichée ou non.

Si cette variable n'existe pas, bash agit comme si elle avait la valeur $'\nreal\t%3lR\nuser\t%3lU\nsys\t%3lS'. Si la valeur est NULL, aucune information de chronométrage n'est affichée. Un caractère final de changement de ligne est ajouté quand la chaîne de format est affichée.

TMOUT

Si configurée en valeur strictement positive, TMOUT est traitée comme le délai par défaut pour la commande interne read. La commande select se termine s'il n'y a pas de saisie au bout de TMOUT secondes lorsque l'entrée vient d'un terminal. Dans un interpréteur interactif, la valeur est interprétée comme une durée en seconde à attendre une ligne de saisie après avoir affiché l'invite de base. Bash se termine après avoir attendu pendant ce temps en seconde si aucune saisie de ligne complète n'est arrivée.

TMPDIR

Si existante, bash utilise sa valeur comme nom de répertoire dans lequel bash crée les fichiers temporaires nécessaires au fonctionnement de l'interpréteur.

auto_resume

Cette variable commande le comportement de l'interpréteur vis-à-vis de l'utilisateur et du contrôle des tâches. Si cette variable existe, les commandes simples constituées d'un seul mot, sans redirection, sont considérées comme de possibles relances de tâches suspendues. Aucune ambiguïté n'est possible, si plusieurs tâches commencent par la chaîne saisie, la tâche à laquelle il a été accédé le plus récemment est sélectionnée. Le nom d'une tâche suspendue, dans ce contexte, est la ligne de commande utilisée pour la lancer. Si configurée à la valeur exact, la chaîne fournie doit correspondre exactement au nom d'une tâche suspendue ; si configurée à substring, la chaîne fournie doit correspondre à une sous-chaîne du nom de la tâche suspendue. La valeur substring donne une fonctionnalité analogue à l'identificateur de tâche %? (consultez CONTRÔLE DES TÂCHES ci-dessous). Si configurée à toute autre valeur, la chaîne fournie doit être le préfixe du nom d'une tâche suspendue ; cela fournit une fonctionnalité analogue à l'identificateur de tâche %string.

histchars

Les deux ou trois caractères commandant le développement de l'historique et le découpage en lexèmes (consultez DÉVELOPPEMENT DE L'HISTORIQUE ci-dessous). Le premier caractère est le caractère de développement de l'historique, celui qui indique le début d'un développement d'historique (normalement « ! »). Le second caractère est celui de substitution rapide, utilisé comme raccourci pour relancer la commande précédente, en modifiant une partie de la chaîne (par défaut « ^ »). Le troisième caractère facultatif est celui qui indique, lorsqu'on le trouve en début de mot que le reste de la ligne est un commentaire (normalement « # »). Ce caractère de commentaire empêche le développement de l'historique pour tous les mots restants sur la ligne. Il ne conduit pas nécessairement l'analyseur de l'interpréteur à considérer le reste de la ligne comme un commentaire.

Tableaux¶

Bash fournit des variables de type tableau indicé ou associatif, à une dimension. Toute variable peut être utilisée comme tableau indicé ; la commande interne declare peut servir à déclarer explicitement un tableau. Il n'y a pas de limitation maximale à la taille d'un tableau, ni d'obligation à indicer les éléments ou les affecter de façon contiguë. Les tableaux indicés sont consultés avec des entiers (évaluations arithmétiques comprises) commençant à zéro ; les tableaux associatifs sont consultés avec des chaînes arbitraires. Sauf mention contraire, les indices de tableaux indicés doivent être des entiers positifs.

Un tableau indicé est créé automatiquement si une variable quelconque est affectée en utilisant la syntaxe nom[indice]=valeur. L'indice est traité comme une expression arithmétique et doit s'évaluer en un nombre. declare -a nom permet de déclarer explicitement un tableau indicé (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). declare -a nom[indice] est aussi accepté ; l'indice est ignoré.

Les tableaux associatifs sont créés en utilisant declare -A nom.

Des attributs peuvent être indiqués pour une variable tableau en utilisant les commandes internes declare et readonly. Les attributs s'appliquent à tous les éléments d'un tableau.

Les tableaux sont affectés en utilisant l'affectation composée de la forme nom=(valeur_1 ... valeur_n), où chaque valeur est de la forme [indice]=chaîne. Les affectations de tableau indicé ne nécessitent rien d’autre que chaîne. Lors de l'affectation de tableaux indicés, si les crochets et les indices facultatifs sont fournis, les affectations ont lieu en conséquence ; sinon l'indice de l'élément affecté est le dernier indice affecté plus un. L'indexation commence à zéro.

Lors de l'affectation d'un tableau associatif, l'indice est obligatoire.

Cette syntaxe est aussi acceptée par la commande interne declare. Les éléments individuels du tableau sont affectés en utilisant la syntaxe nom[indice]=valeur présentée ci-dessus. Lors de l’affectation vers un tableau indicé, si nom est indicé avec un nombre négatif, ce nombre est considéré comme ajouté à l'indice maximal de nom plus un (ainsi un indice négatif compte à rebours depuis la fin du tableau et un indice -1 fait référence au dernier élément du tableau).

Tout élément d'un tableau est accessible avec la notation ${nom[indice]}. Les accolades sont nécessaires pour éviter les conflits avec le développement des chemins. Si indice est @ ou *, le mot se développe en tous les éléments de nom. Ces deux indices ne diffèrent que lorsque le mot apparaît entre guillemets doubles. Si le mot est entre guillemets doubles, ${nom[*]} se développe en un seul mot contenant les valeurs de chaque élément du tableau séparées par le premier caractère de la variable spéciale IFS et ${nom[@]} développe chaque élément de nom en un mot distinct. Quand il n'y a pas d'élément dans le tableau, ${nom[@]} ne se développe en rien. Si le développement entre guillemets doubles survient à l'intérieur d'un mot, le développement du premier paramètre est accolé à la première partie du mot original et le développement du dernier paramètre est accolé à la dernière partie du mot original. Le comportement est analogue à celui des paramètres spéciaux * et @ (consultez Paramètres spéciaux ci-dessus). ${#nom[indice]} s'évalue en longueur de l'élément ${nom[indice]}. Si l'indice est * ou @, s'évalue en nombre d'éléments dans le tableau. Accéder à une variable tableau sans indice est équivalent à accéder à l'élément de tableau d'indice 0. Si l'indice utilisé pour référencer un élément de tableau indicé s'évalue en un nombre négatif, il est considéré comme ajouté à l'indice maximal du tableau plus un (ainsi un indice négatif compte à rebours depuis la fin du tableau et un indice -1 fait référence au dernier élément du tableau).

Une variable tableau est considérée configurée si une valeur a été affectée à un indice. La chaîne NULL est une valeur possible.

Les clefs (indices) d’un tableau peuvent être aussi bien obtenues que les valeurs. ${!nom[@]} et ${!nom[*]} se développent en indices assignés dans la variable tableau nom. Le traitement entre guillemets doubles est similaire au développement des paramètres spéciaux @ et * entre guillemets doubles.

La commande interne unset sert à détruire les tableaux. unset nom[indice] détruit l'élément de tableau d'indice indice. Les indices négatifs des tableaux indicés sont traités comme décrit précédemment. Un soin particulier doit être apporté afin d'éviter des effets de bords non désirés provoqués par le développement des chemins. unset nom, où nom est un tableau, ou unset nom[indice], avec indice valant * ou @ supprime le tableau entier.

Les commandes internes declare, local et readonly acceptent toutes une option -a pour préciser un tableau indicé et une option -A pour préciser un tableau associatif. Si les deux options sont fournies, -A est prioritaire. La commande interne read accepte une option -a pour affecter une liste de mots lus depuis l'entrée standard dans un tableau. Les commandes internes set et declare affichent les valeurs d'un tableau d'une façon qui permet de les réutiliser pour des affectations.

Développement des accolades¶

Le développement des accolades est un mécanisme permettant de produire des chaînes quelconques. Il est similaire au développement des chemins, mais les noms de fichiers produits n'existent pas nécessairement. Les motifs qui seront développés prennent la forme d'un préambule facultatif, suivi soit par une série de chaînes séparées par des virgules, soit par l'expression d'une série entre accolades, et suivi par un post-scriptum facultatif. Le préambule est inséré devant chacune des chaînes contenues entre les accolades et le post-scriptum est concaténé à la fin de chacune des chaînes résultantes, le développement se faisant de gauche à droite.

Plusieurs développements d'accolades peuvent être imbriqués. Les résultats de chaque développement ne sont pas triés, l'ordre de gauche à droite est conservé. Par exemple a{d,c,b}e se développe en « ade ace abe ».

Une expression de série est de la forme {x..y[..incr]}, où x et y sont soit des entiers, soit des caractères uniques, et incr, un incrément facultatif, est un entier. Lorsqu'il s'agit d'entiers, l'expression est remplacée par la liste des nombres entre x et y inclus. Les entiers fournis peuvent être préfixés par 0 pour forcer chaque terme à avoir la même longueur. Si x ou y commencent par un zéro, l'interpréteur essaiera de forcer tous les termes créés à la même longueur, en ajoutant des zéros au besoin. S'il s'agit de caractères, l'expression se développe en l’ensemble des caractères situés entre x et y, inclus, d'un point de vue lexicographique en utilisant les paramètres régionaux par défaut de C. Remarquez que x et y doivent être du même type. Si l'incrément est fourni, il est utilisé comme différence entre chaque terme. L'incrément par défaut est 1 ou -1 suivant les valeurs de x et y.

Le développement des accolades est effectué avant tout autre développement et tous les caractères ayant une signification spéciale pour les autres développements sont conservés dans le résultat. Il s'agit d'une modification purement littérale. Bash n'effectue aucune interprétation syntaxique du texte entre les accolades.

Un développement d'accolades correctement formé doit contenir des accolades ouvrante et fermante non protégées et au moins une virgule non protégée ou une expression de série correcte. Tout développement d'accolades incorrectement formé est laissé inchangé. Un { ou un , peuvent être protégés par une contre-oblique pour éviter d'être considérés comme partie d'une expression entre accolades. Pour éviter tout conflit avec le développement des paramètres, la chaîne ${ n'est pas considérée comme éligible au développement des accolades.

Cette construction est typiquement utilisée comme raccourci lorsque le préfixe commun aux chaînes à engendrer est plus long que dans l'exemple ci-dessous :

Le développement des accolades induit une légère incompatibilité avec les versions historiques de sh. sh n'effectue aucun traitement sur les accolades ouvrantes et fermantes lorsqu'elles apparaissent dans un mot et les laisse inchangées. Bash supprime les accolades dans les mots, après développement. Par exemple, si le mot file{1,2} est fourni à sh, il reste inchangé en sortie. En revanche, il est transformé en file1 file2 par bash. Si une compatibilité stricte avec sh est nécessaire, lancez bash avec l'option +B ou désactivez le développement des accolades avec l'option +B de la commande set (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

Développement du tilde¶

Si un mot commence par un caractère tilde (« ~ ») non protégé, tous les caractères précédant la première barre oblique non protégée (voire tous les caractères s'il n'y a pas de barre oblique non protégée), sont considérés comme un préfixe tilde. Si aucun caractère du préfixe tilde n'est protégé, les caractères suivant le tilde sont traités comme un identifiant de connexion possible. Si cet identifiant de connexion est la chaîne NULL, le tilde est remplacé par la valeur du paramètre d'interpréteur HOME. Si HOME n'existe pas, le répertoire d'accueil de l'utilisateur exécutant l'interpréteur est utilisé à la place. Sinon le préfixe tilde est remplacé par le répertoire d'accueil associé à l'identifiant de connexion indiqué.

Si le préfixe tilde est « ~+ », la valeur de la variable de l'interpréteur PWD le remplace. Si le préfixe tilde est « ~- », la valeur de la variable de l'interpréteur OLDPWD, si existante, lui est substituée. Si les caractères à la suite du tilde dans le préfixe tilde représentent un nombre N préfixé facultativement par un « + » ou un « - » le préfixe tilde est remplacé par l'élément correspondant de la pile de répertoires telle qu'il serait affiché par la commande interne dirs appelée avec le préfixe tilde en argument. Si les caractères à la suite du tilde dans le préfixe tilde représentent un nombre sans un « + » ou « - » en tête, on suppose qu'il s'agit de « + ».

Si l'identifiant de connexion est incorrect ou si le développement du tilde échoue, le mot est inchangé.

Chaque affectation de variable vérifie immédiatement la présence de préfixes tilde non protégés suivant un : ou le premier =. Dans ces cas, le développement des tildes est aussi effectué. On peut donc utiliser des noms de fichiers avec des tildes dans des affectations de PATH, MAILPATH et CDPATH et l'interpréteur affectera la valeur développée.

Remplacement des paramètres¶

Le caractère « $ » permet d'introduire le développement des paramètres, la substitution de commande ou le développement arithmétique. Le nom du paramètre ou du symbole à développer peut être encadré par des accolades facultatives mais permettant d'éviter le développement de la variable à partir de caractères la suivant immédiatement et qui pourraient être considérés comme appartenant à son nom.

Lorsque les accolades sont utilisées, l'accolade de fin correspondante est le premier caractère « } » ni protégé par une contre-oblique, ni inclus dans une chaîne protégée, un développement arithmétique, une substitution de commande ou un développement des paramètres.

${paramètre}

est remplacé par la valeur du paramètre. Les accolades sont nécessaires quand le paramètre est un paramètre positionnel ayant plusieurs chiffres, ou si le paramètre est suivi de caractères n'appartenant pas à son nom. Le paramètre est un paramètre d’interpréteur (comme décrit précédemment dans PARAMÈTRES) ou une référence de tableau (Tableaux).

Si le premier caractère du paramètre est un point d'exclamation (!), il introduit un niveau d'imbrication de variable. Bash utilise la valeur de la variable formée par le reste du paramètre comme un nom de variable. Cette variable est alors développée et la valeur utilisée pour le reste de la substitution plutôt que la valeur du paramètre lui-même. On appelle ce mécanisme le développement imbriqué. Les exceptions à celui-ci sont les développements de ${!préfixe*} et de ${!nom[@]} décrits ci-dessous. Le point d'exclamation doit immédiatement suivre l'accolade ouvrante afin d'introduire l'imbrication.

Dans chacun des cas ci-dessous, le mot est soumis au développement du tilde, au développement des paramètres, à la substitution de commande et au développement arithmétique.

Quand il n'effectue pas de développement de sous-chaîne, en utilisant les formes documentées ci-dessous (par exemple :-), bash teste si le paramètre est inexistant ou NULL. L'absence de deux-points induit un test sur la seule inexistence du paramètre.

${paramètre:-mot}

Utilisation de valeur par défaut. Si le paramètre est inexistant ou NULL, le développement du mot est substitué. Sinon, c'est la valeur du paramètre qui est substituée.

${paramètre:=mot}

Affectation de valeur par défaut. Si le paramètre est inexistant ou NULL, le développement du mot lui est affecté. La valeur du paramètre est alors substitué. Les paramètres positionnels et spéciaux ne peuvent pas être affectés de cette façon.

${paramètre:?mot}

Affichage d'erreur si NULL ou inexistant. Si le paramètre est inexistant ou NULL, le développement du mot (ou un message approprié si aucun mot n'est fourni) est affiché sur la sortie d'erreur standard et l'interpréteur termine, s'il n'est pas interactif. Sinon, la valeur du paramètre est substituée.

${paramètre:+mot}

Utilisation de valeur alternative. Si le paramètre est NULL ou inexistant, rien n'est substitué. Sinon le développement du mot est substitué.

${paramètre:début}

${paramètre:début:longueur}

Développement des sous-chaînes. Se développe pour fournir la sous-chaîne de longueur indiquée (en caractère) commençant au début. Si le paramètre est @, un tableau indicé par @ ou *, ou un nom de tableau associatif, le résultat diffère comme décrit ci-dessous. Si la longueur est omise, fournit la sous-chaîne commençant au caractère indiqué par début et s'étendant jusqu'à la fin de la valeur. La longueur et le début sont des expressions arithmétiques (consultez ÉVALUATION ARITHMÉTIQUE ci-dessous).

Si le début est négatif, sa valeur est considérée à partir de la fin du contenu du paramètre. Si longueur est négatif, sa valeur est considérée comme une position en caractère à partir de la fin de la valeur de paramètre plutôt que comme un nombre de caractères, et le développement est constitué des caractères entre le début et cette position. Remarquez que les positions négatives doivent être séparées des deux-points par au moins une espace pour éviter d’être confondues avec le développement de :-.

Si le paramètre est @, le résultat correspond à longueur paramètres positionnels commençant au début. Une valeur négative de début est considérée relative au plus grand paramètre positionnel plus un (ainsi un indice -1 fait référence au dernier paramètre positionnel). C’est une erreur de développement si longueur est évaluée en nombre négatif.

Si le paramètre est un nom de tableau indicé par @ ou *, le résultat est les longueur éléments du tableau commençant à ${paramètre[début]}. Une valeur négative de début est prise relativement à la valeur maximale de l'indice du tableau considéré plus un. C’est une erreur de développement si longueur est évaluée en nombre négatif.

Le développement de sous-chaîne appliqué à un tableau associatif produit des résultats non définis.

L'indexation des sous-chaînes commence à zéro, sauf pour les paramètres positionnels pour lesquels l'indexation commence à 1 par défaut. Si début est 0, et que les paramètres positionnels sont utilisés, la liste est préfixée par $0.

${!préfixe*}

${!préfixe@}

Noms correspondant au préfixe. Se développe en noms des variables dont les noms commencent par préfixe, séparés par le premier caractère de la variable spéciale IFS. Si @ est utilisé et que le développement apparaît entre guillemets doubles, chaque nom de variable se développe séparément.

${!nom[@]}

${!nom[*]}

Liste des clefs du tableau. Si nom est une variable de type tableau, elle se développe en liste des indices (clefs) du tableau affecté à nom. Si nom n'est pas un tableau, se développe en 0 si nom existe et en NULL sinon. Quand @ est utilisé et que le développement apparaît entre guillemets doubles, chaque clef se développe en un mot séparé.

${#paramètre}

Longueur du paramètre. Est remplacé par la longueur, en caractères, de la valeur du paramètre. Si le paramètre est * ou @, la valeur est le nombre de paramètres positionnels. Si le paramètre est un nom de tableau indicé par * ou @, la valeur donnée est le nombre d'éléments du tableau. Si le paramètre est un nom de tableau indicé par un nombre négatif, ce nombre est considéré comme ajouté à l'indice maximal de paramètre plus un (ainsi un indice négatif compte à rebours depuis la fin du tableau et un indice -1 fait référence au dernier élément).

${paramètre#mot}

${paramètre##mot}

Retrait du motif correspondant au préfixe. Le mot est développé pour fournir un motif, comme dans le développement des chemins. Si le motif correspond au début de la valeur du paramètre, alors le développement prend la valeur développée du paramètre après suppression du plus court (cas « # ») ou du plus long (cas « ## ») motif correspondant. Si le paramètre est @ ou *, l'opération de suppression de motif est appliquée à chaque paramètre positionnel tour à tour et le développement est la liste résultante. Si le paramètre est une variable tableau indicée par @ ou *, l'opération de suppression de motif est appliquée à chaque élément du tableau tour à tour et le développement est la liste résultante.

${paramètre%mot}

${paramètre%%mot}

Retrait du motif correspondant au suffixe. Le mot est développé pour fournir un motif, comme dans le développement des chemins. Si le motif correspond à une portion finale de la valeur développée du paramètre, alors le développement prend la valeur développée du paramètre après suppression du plus court (cas « % ») ou du plus long (cas « %% ») motif correspondant. Si le paramètre est @ ou *, l'opération de suppression de motif est appliquée à chaque paramètre positionnel tour à tour et le développement est la liste résultante. Si le paramètre est une variable tableau indicée par @ ou *, l'opération de suppression de motif est appliquée à chaque élément du tableau tour à tour et le développement est la liste résultante.

${paramètre/motif/chaîne}

Substitution de motif. Le motif est développé comme dans le traitement des chemins. Le paramètre est développé et la plus longue portion correspondant au motif est remplacée par la chaîne. Si le motif commence par /, toutes les correspondances au motif sont remplacées par la chaîne. Normalement, seule la première correspondance est remplacée. Si le motif commence par #, il doit correspondre au début de la valeur développée du paramètre. Si le motif commence par %, il doit correspondre à la fin du développement du paramètre. Si la chaîne est NULL, les portions correspondant au motif sont supprimées et le / suivant le motif peut être omis. Si le paramètre est @ ou *, l'opération de substitution est appliquée à chacun des paramètres positionnels tour à tour et le développement est la liste résultante. Si le paramètre est une variable tableau indicée par @ ou *, l'opération de substitution s'applique à chaque élément du tableau tour à tour et le développement est la liste résultante.

${paramètre^motif}

${paramètre^^motif}

${paramètre,motif}

${paramètre,,motif}

Modification de la casse. Ce développement modifie la casse des caractères alphabétiques du paramètre. Le motif est développé pour fournir un motif, comme dans le développement des chemins. Chaque caractère de la valeur développée de paramètre est testé par rapport au motif et, en cas de correspondance, sa casse est convertie. Le motif ne devrait pas essayer de correspondre à plus d’un caractère. L'opérateur ^ convertit les lettre minuscules correspondant à ce motif en majuscules ; l'opérateur , convertit les lettre majuscules correspondant à ce motif en minuscules. Les développements ^^ et ,, convertissent tous les caractères correspondant à leur valeur développée ; les développements ^ et , convertissent seulement le premier caractère de la valeur développée correspondant. Si motif est omis, il est traité comme un ?, ce qui correspond à n'importe quel caractère. Si le paramètre est @ ou *, la modification de casse s'applique à chaque paramètre positionnel tour à tour et le développement est la liste résultante. Si le paramètre est une variable tableau indicée par @ ou *, la modification de casse s'applique à chaque élément du tableau tour à tour et le développement est la liste résultante.

Substitution de commande¶

La substitution de commande permet de remplacer le nom d'une commande par son résultat. Il en existe deux formes :

Bash effectue la substitution en exécutant la commande et en la remplaçant par sa sortie standard dont les éventuels sauts de lignes finaux sont supprimés. Les changements de ligne internes ne sont pas supprimés mais peuvent disparaître lors du découpage en mots. La substitution de commande $(cat fichier) peut être remplacée par l'équivalent plus rapide $(< fichier).

Quand l'ancienne forme de substitution avec les accents graves « ` » est utilisée, le caractère contre-oblique garde sa signification propre sauf lorsqu'il est suivi de $, ` ou \. Le premier accent grave non protégé par une contre-oblique termine la substitution de commande. Quand on utilise la forme $(commande), tous les caractères entre parenthèses constituent la commande ; aucun n'est traité spécifiquement.

Les substitutions de commande peuvent être imbriquées. Pour imbriquer en utilisant la forme à accents graves, il faut protéger les accents graves internes avec des contre-obliques.

Si la substitution apparaît entre guillemets doubles, le découpage en mots et le développement des chemins ne sont pas effectués sur ses résultats.

Développement arithmétique¶

Le développement arithmétique permet de remplacer une expression arithmétique par le résultat de son évaluation. Le format du développement arithmétique est :

L'ancien format $[expression] est obsolète et sera supprimé dans les prochaines versions de bash.

L'expression est traitée comme si elle était entre guillemets doubles, mais un guillemet double à l'intérieur de parenthèses n'est pas traité spécifiquement. Tous les lexèmes dans l'expression sont sujet au développement des paramètres et des variables, à la substitution de commande et à la suppression des protections. Le résultat est traité comme l’expression arithmétique à évaluer. Les développements arithmétiques peuvent être imbriqués.

L'évaluation est effectuée en suivant les règles décrites ci-dessous dans ÉVALUATION ARITHMÉTIQUE. Si l'expression est incorrecte, bash affiche un message indiquant l'échec et aucune substitution n'a lieu.

Substitution de processus¶

La substitution de processus n'est disponible que sur les systèmes acceptant le mécanisme des tubes nommés (FIFO) ou la méthode /dev/fd de noms de fichiers. Elle prend la forme <(liste) ou >(liste). La liste de processus est exécutée avec son entrée ou sa sortie connectée à une FIFO ou à un fichier dans /dev/fd. Le nom de ce fichier est passé en argument à la commande qui sera exécutée comme résultat de cette substitution. Si on utilise la forme >(liste), l'écriture dans le fichier fournira des entrées pour la liste. Si la forme <(liste) est utilisée, le fichier passé en argument devra être lu pour obtenir la sortie de la liste.

Sur les systèmes qui le permettent, la substitution de processus est effectuée simultanément au développement des paramètres et variables, à la substitution de commande et au développement arithmétique.

Découpage en mots¶

Les résultats du développement des paramètres, de la substitution de commande et du développement arithmétique qui ne se trouvent pas entre guillemets doubles sont analysés par l'interpréteur afin d'appliquer le découpage en mots.

L'interpréteur considère chaque caractère du paramètre IFS comme un délimiteur et découpe le résultat des autres développements en mots utilisant ces caractères comme terminaisons de champ. Si IFS est inexistante ou si sa valeur est exactement <espace><tab><changement de ligne>, la valeur par défaut, alors les suites de caractères <espace>, <tab> et <changement de ligne> au début ou à la fin du résultat des développements précédents sont ignorés, et toute suite de caractères de IFS ni au début ni à la fin sert à délimiter les mots. Si IFS a une valeur autre que celle par défaut, alors les suites de caractères blancs espace et tabulation sont ignorées en début et fin de mot, à condition que ces caractères blancs se trouvent dans la valeur de IFS (un caractère blanc de IFS). Tout caractère de IFS qui n'est pas un caractère blanc, se trouvant à côté d'un caractère blanc de IFS, délimite un champ. Une suite de caractères blancs de IFS est également traitée comme un délimiteur. Si la valeur de IFS est NULL, aucun découpage en mots n'a lieu.

Les arguments NULL explicites ("" ou '') sont conservés. Les arguments NULL implicites non protégés, résultant du développement des paramètres qui n'ont pas de valeurs, sont supprimés. Si un paramètre sans valeur est développé entre guillemets doubles, le résultat est un argument NULL qui est conservé.

Remarquez que si aucun développement n'a lieu, le découpage en mots n'est pas effectué.

Développement des chemins¶

Après le découpage en mots, à moins que l'option -f soit présente, bash recherche dans chaque mot les caractères *, ? et [. Si l'un d'eux apparaît, le mot est considéré comme un motif et remplacé par une liste, classée par ordre alphabétique, des noms de fichiers correspondant à ce motif (consultez Motifs génériques ci-dessous). Si aucun nom de fichier ne correspond et si l'option d'interpréteur nullglob n'est pas activée, le mot reste inchangé. Si l'option nullglob existe et si aucune correspondance n'est trouvée, le mot est supprimé. Si l'option d'interpréteur failglob existe et si aucune correspondance n'est trouvée, un message d'erreur est affiché et la commande n'est pas exécutée. Si l'option d'interpréteur nocaseglob est activée, la correspondance est effectuée sans tenir compte de la casse des caractères alphabétiques. Remarquez que lorsque des expressions d’intervalle comme [a-z] (voir ci-dessous) sont utilisées les lettres de l'autre casse peuvent être incluses, selon le paramétrage de LC_COLLATE. Quand un motif est utilisé pour le développement des chemins, le caractère « . » au début d'un nom ou immédiatement à la suite d'une barre oblique doit être explicitement mis en correspondance, à moins que l'option d'interpréteur dotglob n'existe. Lors de la correspondance avec un chemin, le caractère barre oblique doit toujours être mis en correspondance explicitement. Dans les autres cas, le caractère « . » n'est pas traité spécifiquement. Voyez la description de la commande shopt dans COMMANDES INTERNES DE L'INTERPRÉTEUR pour une description des options d'interpréteur nocaseglob, nullglob, failglob et dotglob.

La variable de l'interpréteur GLOBIGNORE peut servir à restreindre l'ensemble des noms de fichiers correspondant à un motif. Si GLOBIGNORE existe, chaque nom de fichier qui correspond aussi à un motif de GLOBIGNORE est supprimé de la liste des correspondances. Les noms de fichiers « . » et « .. » sont toujours ignorés quand GLOBIGNORE existe et n'est pas NULL. Toutefois, configurer GLOBIGNORE avec une valeur non NULL a pour effet d'activer l'option d'interpréteur dotglob, ainsi tous les autres noms de fichiers commençant par « . » correspondront. Pour obtenir l'ancien comportement ignorant les noms commençant par « . », placez « .* » dans l'un des motifs de GLOBIGNORE. L'option dotglob est désactivée si la variable GLOBIGNORE est inexistante.

Motifs génériques

Tout caractère apparaissant dans un motif, hormis les caractères spéciaux décrits ci-dessous, correspond à lui-même. Le caractère NUL ne peut pas se trouver dans un motif. Une contre-oblique protège le caractère qui la suit ; la contre-oblique de protection est supprimée lors de la recherche de correspondance. Les caractères spéciaux de motifs doivent être protégés s'ils sont destinés à une correspondance littérale.

Les caractères spéciaux ont les significations suivantes :

Si l'option extglob d'interpréteur est activée par la commande interne shopt plusieurs opérateurs de correspondance étendue sont reconnus. Dans la description suivante, une liste-motif est une liste d'un ou plusieurs motifs séparés par des |. Les motifs composés sont formés en utilisant un ou plusieurs sous-motifs comme suit :

Suppression des protections¶

Après les développements précédents, toutes les occurrences non protégées des caractères \, ' et " qui ne résultent pas d'un des développements ci-dessus sont supprimées.

Redirection d'entrée¶

Une redirection d'entrée conduit à l'ouverture en lecture avec le descripteur de fichier numéro n du fichier dont le nom résulte du développement du mot ou en tant qu'entrée standard (descripteur de fichier 0) si n n'est pas indiqué.

Le format général des redirections d'entrée est :

Redirection de sortie¶

Une redirection de sortie conduit à l'ouverture en écriture du fichier dont le nom résulte du développement du mot avec comme descripteur de fichier n ou en tant que sortie standard (descripteur de fichier 1) si n n'est pas indiqué. Si le fichier n'existe pas, il est créé. S'il existait déjà, sa taille est réduite à zéro.

Le format général des redirections de sortie est le suivant :

Si l'opérateur de redirection est > et si l'option noclobber de la commande interne set est activée, la redirection échouera si le fichier dont le nom résulte du développement du mot existe et est un fichier normal. Si l'opérateur de redirection est >| ou l'opérateur > avec l'option noclobber de la commande interne set n'est pas activée, la redirection sera tentée même si le fichier dont le nom résulte du développement du mot existe.

Ajout d'une sortie redirigée¶

La redirection de la sortie de cette façon conduit à l'ouverture du fichier dont le nom résulte du développement du mot pour ajouter au descripteur de fichier n ou à la sortie standard (descripteur de fichier 1) si n n'est pas indiqué. Si le fichier n'existe pas, il est créé.

Le format général pour les sorties avec ajout est :

Redirection de la sortie standard et de la sortie d'erreur standard¶

Cette construction permet la redirection simultanée de la sortie standard (descripteur 1) et de la sortie d'erreur standard (descripteur 2), dans un fichier dont le nom est le résultat du développement du mot.

Il y a deux formes pour rediriger les sortie standard et sortie d'erreur standard :

La première des deux formes est préférée. C'est sémantiquement équivalent à

En utilisant la deuxième forme, mot ne peut pas être développé en nombre ou -. Si c’est le cas, les autres opérateurs de redirection s’appliquent (consultez Dédoublement de descripteurs de fichier ci-dessous) pour des raisons de compatibilité.

Ajout de la sortie standard et de la sortie d'erreur standard¶

Cette construction permet l'ajout simultané de la sortie standard (descripteur 1) et de la sortie d'erreur standard (descripteur 2), dans un fichier dont le nom est le résultat du développement du mot.

La forme pour ajouter les sortie standard et sortie d'erreur standard est :

C'est sémantiquement équivalent à

(consultez Dédoublement de descripteurs de fichier ci-dessous).

Document en ligne¶

Ce type de redirection commande à l'interpréteur de lire son entrée de la source actuelle jusqu'à ce qu'il voie une ligne contenant seulement le délimiteur prévu (sans blancs finaux). Toutes les lignes lues jusqu'à ce point sont ensuite utilisées comme l'entrée standard pour une commande.

Le format des documents en ligne est le suivant :

<<[-]mot


        document_en_ligne
délimiteur

Aucun développement des paramètres ou des variables, ni substitution de commande, ni développement arithmétique ou des chemins n’est effectué sur le mot. Si un des caractères du mot est protégé, délimiteur est le résultat de la suppression des protections sur mot et les lignes du document_en_ligne ne sont pas développées. Si mot n'est pas protégé, toutes les lignes du document_en_ligne sont soumises au développement des paramètres, à la substitution de commande et au développement arithmétique, la suite de caractères \<changement de ligne> est ignorée et \ doit être utilisée pour protéger les caractères \, $ et `.

Si l'opérateur de redirection est <<-, alors les tabulations en tête de chaque ligne sont supprimées de l'entrée, y compris dans la ligne contenant délimiteur. Cela permet d'indenter de façon naturelle les documents en ligne au sein des scripts.

Chaînes en ligne¶

Une variante aux documents en ligne, le format est :

<<<mot

Le mot est sujet au développement des accolades, du tilde, des paramètres et des variables, à la substitution de commande, au développement arithmétique et à la suppression des protections. Ni le développement des chemins, ni le découpage en mots n’est réalisé. Le résultat est fourni comme une seule chaîne à la commande sur son entrée standard.

Dédoublement de descripteurs de fichier¶

L'opérateur de redirection

permet de dupliquer les descripteurs de fichiers en entrée. Si le mot se transforme en un ou plusieurs chiffres, le descripteur de fichier noté par n devient une copie de ce descripteur. Si les chiffres du mot ne correspondent pas à un descripteur ouvert en lecture, une erreur de redirection se produit. Si le mot prend la forme -, le descripteur n est fermé. Si n n'est pas mentionné, l'entrée standard (descripteur 0) est utilisée.

L'opérateur

est utilisé de façon similaire pour dupliquer les descripteurs de sortie. Si n n'est pas explicité, la sortie standard (descripteur 1) est utilisée. Si les chiffres du mot ne correspondent pas à un descripteur en écriture, une erreur de redirection se produit. Si mot est évalué en -, le descripteur de fichier n est fermé. Dans le cas particulier où n est omis et où mot ne se développe pas en un ou plusieurs chiffres, ou -, les sorties standard et d'erreur standard sont toutes deux redirigées comme décrit précédemment.

Déplacement de descripteurs de fichiers¶

L'opérateur de redirection

déplace le descripteur de fichier chiffre vers le descripteur de fichier n ou sur l'entrée standard (descripteur de fichier 0) si n n'est pas indiqué. chiffre est fermé après avoir été dupliqué en n.

De la même façon, l'opérateur de redirection

déplace le descripteur de fichier chiffre vers le descripteur de fichier n ou sur la sortie standard (descripteur de fichier 1) si n n'est pas indiqué.

Ouverture en Lecture/Écriture d'un descripteur de fichier¶

L'opérateur de redirection

conduit à l'ouverture du fichier dont le nom résulte du développement du mot, à la fois en lecture et en écriture et lui affecte le descripteur de fichier n ou bien le descripteur 0 si n n'est pas mentionné. Si le fichier n'existe pas, il est créé.

Notation readline¶

Dans ce paragraphe on utilisera la notation « à la Emacs » pour indiquer les frappes de touches. Les touches Contrôle sont notées C-touche, par exemple C-n signifie Contrôle-N. De même, les touches Méta sont notées par M-touche, ainsi M-x signifie Méta-X. (Sur les claviers sans touches Méta, M-x signifie ESC x, c'est-à-dire presser la touche d'Échappement puis la touche x. Cela fait de ESC le préfixe méta. La combinaison M-C-x signifie ESC-Contrôle-x ou encore presser la touche d'Échappement puis maintenir la touche Contrôle enfoncée tout en pressant la touche x.)

Les commandes readline peuvent recevoir des arguments numériques, qui fonctionnent en règle générale comme compteurs de répétitions. Parfois, cependant, c'est le signe de l'argument qui est significatif. L'utilisation d'un argument négatif pour une commande agissant dans un sens donné (par exemple kill-line) conduit cette commande à agir dans la direction opposée. Les commandes dont le comportement avec les arguments diffère de cela sont indiquées ci-dessous.

Lorsqu'une commande est indiquée comme détruisant du texte, le texte effacé est en fait sauvegardé pour une éventuelle récupération ultérieure (« yanking »). Il est conservé dans un tampon circulaire (« kill ring »). Les suppressions successives conduisent à l'accumulation du texte en un seul bloc qui peut être récupéré en une fois. Les commandes non destructives séparent les blocs de textes dans le tampon circulaire.

Initialisation de readline¶

Readline est personnalisé en plaçant des commandes dans un fichier d'initialisation (le fichier inputrc). Le nom de ce fichier est pris dans la variable de l'interpréteur INPUTRC. Si cette variable est inexistante, le nom par défaut est ~/.inputrc. Lorsqu'un programme utilisant la bibliothèque readline démarre, le fichier d'initialisation est lu et les raccourcis clavier et les variables sont mis en place. Il n'y a que quelques constructions élémentaires possibles dans le fichier d'initialisation de readline. Les lignes blanches sont ignorées. Les lignes commençant par # sont des commentaires. Les lignes commençant par $ indiquent des constructions conditionnelles. Les autres lignes indiquent des raccourcis clavier et des paramétrages de variables.

Les raccourcis clavier par défaut peuvent être modifiés par un fichier inputrc. D'autres programmes qui utilisent cette bibliothèque peuvent ajouter leurs propres commandes et raccourcis.

Par exemple, en plaçant

Les caractères symboliques suivants sont acceptés : RUBOUT, DEL, ESC, LFD, NEWLINE, RET, RETURN, SPC, SPACE et TAB.

En plus des noms de commandes, readline permet d'associer à une touche une chaîne de caractères qui sera insérée lorsque la touche est pressée (une macro).

Raccourcis clavier readline¶

La syntaxe de définition des raccourcis clavier dans le fichier inputrc est simple. Tout ce qui est nécessaire est le nom de la commande ou le texte d'une macro et la suite de touches à laquelle il faut l'associer. Les noms de touches peuvent être indiqués de l'une des deux façons : comme un nom de touche symbolique, éventuellement précédé des préfixes Meta- ou Control- ou sous forme d'une suite de touches.

En utilisant la forme touche:nom_de_fonction ou macro, touche est le nom de la touche en anglais. Par exemple :

Dans l'exemple ci-dessus, C-u est associé à la fonction universal-argument, M-DEL à la fonction backward-kill-word et C-o à l'exécution de la macro exprimée dans la partie gauche (c'est-à-dire, insérer le texte « > sortie » sur la ligne).

Avec la seconde forme, "touches":nom_de_fonction ou macro, touches diffère de touche ci-dessus en ce que les chaînes notant une suite complète de touches peuvent être indiquées en plaçant la suite entre guillemets doubles. Certaines suites de touches d'Échappement dans le style GNU Emacs peuvent être utilisées, comme dans l'exemple suivant, mais les noms de caractères symboliques ne sont pas reconnus.

Dans cet exemple, C-u est à nouveau associé à la fonction universal-argument, C-x C-r à la fonction re-read-init-file et ESC [ 1 1 ~ à l'insertion du texte « Function Key 1 ».

Le jeu complet des suites de caractères de protection du style GNU Emacs est :

En plus des suites de caractères de protection dans le style GNU Emacs, un second jeu de suites de caractères de protection par contre-obliques est disponible :

Lorsqu'on saisit le texte d'une macro, il faut utiliser des guillemets simples ou doubles pour indiquer la définition de la macro. Les textes non protégés sont considérés comme des noms de fonctions. Dans le corps de la macro, les protections par contre-oblique décrites ci-dessus sont développées. La contre-oblique protégera tout autre caractère dans le texte de la macro, y compris " et '.

Bash permet d'afficher ou de modifier les raccourcis clavier readline avec la commande interne bind. On peut basculer d'un mode d'édition à l'autre en mode interactif en utilisant l'option -o de la commande interne set (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

Variables de readline¶

Readline dispose de variables permettant de personnaliser encore plus son comportement. Une variable peut être configurée dans le fichier inputrc avec une affectation de la forme

Sauf indication contraire, les variables de readline prennent les valeurs On ou Off (la casse étant sans importance). Les noms de variables non reconnues sont ignorés. Lorsqu'une valeur de variable est lue, les variables vides ou de valeur NULL, « on » (insensible à la casse) et « 1 » sont équivalentes à On. Toutes les autres valeurs sont équivalentes à Off. Les variables et leurs valeurs par défaut, sont :

bell-style (audible)

Cette variable commande readline lorsqu'il faut déclencher l'alarme du terminal. Si configurée à none, readline n'émet jamais d'alarme. Si configurée à visible, readline utilise une alarme visuelle s'il y en a une disponible. Si configurée à audible, readline essaie de faire sonner l'alarme du terminal.

bind-tty-special-chars (On)

Si configurée à On, readline tente d'associer les caractères de contrôle traités spécialement par le pilote de terminal du noyau à leurs équivalents readline.

colored-stats (Off)

Si configurée à On, readline affiche les complètements possibles en utilisant des couleurs différentes pour indiquer leur type de fichier. Les définitions de couleur sont prises dans la valeur de la variable d’environnement LS_COLORS.

comment-begin (« # »)

Cette chaîne est insérée quand la commande readline insert-comment est exécutée. Cette commande est associée à M-# en mode Emacs et à # en mode de commande vi.

completion-ignore-case (Off)

Si configurée à On, readline effectue les correspondances et complètements de noms de fichiers sans tenir compte de la casse.

completion-prefix-display-length (0)

La longueur, en caractères, du préfixe commun d'une liste de complètements possibles affiché sans modification. Si configurée en valeur positive, les préfixes communs plus longs que cette valeur sont remplacés par une ellipse lors de l'affichage des complètements possibles.

completion-query-items (100)

Cela détermine quand l'utilisateur est interrogé pour voir le nombre de complètements possibles produits par la commande possible-completions. Elle peut être configurée à toute valeur entière positive. Si le nombre de complètements possibles est supérieur ou égal à la valeur de cette variable, il est demandé à l'utilisateur s'il veut ou non les voir ; sinon, ils sont simplement affichés sur le terminal.

convert-meta (On)

Si configurée à On, readline transformera les caractères avec leur huitième bit à 1 en suite de caractères ASCII en supprimant le huitième bit et en insérant comme préfixe un caractère de protection (en fait, en utilisant le caractère de protection comme préfixe méta).

disable-completion (Off)

Si configurée à On, readline empêchera le complètement des mots. Les caractères de complètement seront insérés sur la ligne comme s'ils avaient été associés à self-insert.

editing-mode (emacs)

Commande si readline doit démarrer avec des raccourcis clavier similaires à Emacs ou à vi. editing-mode peut être positionné soit à emacs, soit à vi.

echo-control-characters (On)

Si configurée à On, sur les systèmes d'exploitation le permettant, readline affiche un caractère correspondant à un signal provenant du clavier.

enable-keypad (Off)

Quand configurée à On, readline essayera d'activer le pavé numérique de l'application une fois appelée. Sur certains systèmes, c'est nécessaire pour utiliser les flèches.

enable-meta-key (On)

Quand configurée à On, readline essayera d'activer toutes les touches de modificateur Méta que le terminal peut prendre en charge une fois appelé. Sur de nombreux terminaux, la touche Méta est utilisée pour saisir des caractères sur huit bits.

expand-tilde (Off)

Si configurée à On, le développement du tilde est effectué lorsque readline tente un complètement de commandes.

history-preserve-point (Off)

Si configurée à On, le programme d'historique tente de placer le curseur au même endroit sur chaque ligne d'historique récupérée avec previous-history ou next-history.

history-size (0)

Configure le nombre d'éléments sauvegardés dans la file de l'historique. Si configurée à zéro, tous les éléments sont effacés et aucun nouvel élément n’est sauvegardé. Si configurée à une valeur strictement négative, le nombre d'éléments de la file d’historique n'est pas limité. Par défaut, le nombre d’éléments n’est pas limité.

horizontal-scroll-mode (Off)

Quand configurée à On, readline utilisera une seule ligne d'affichage et fera défiler la saisie horizontalement sur une seule ligne d'écran quand elle devient plus longue que la largeur de l'écran, plutôt que de faire un retour à la ligne.

input-meta (Off)

Si configurée à On, readline acceptera des saisies sur huit bits (autrement dit il ne supprimera pas le huitième bit), quel que soit le terminal utilisé. Le nom meta-flag est un synonyme pour cette variable.

isearch-terminators (« C-[C-J »)

La chaîne de caractères qui doit terminer une recherche incrémentale sans que le caractère ne soit exécuté comme une commande. Si cette variable n'a pas reçu de valeur, les caractères ESC et C-J termineront une recherche incrémentale.

keymap (emacs)

Configure le jeu de raccourcis readline actuel. L'ensemble des noms corrects de jeux de raccourcis est emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-command et vi-insert. vi est équivalent à vi-command ; emacs est équivalent à emacs-standard. La valeur par défaut est emacs ; la valeur de editing-mode modifie aussi le jeu de raccourcis par défaut.

keyseq-timeout (500)

Indique le temps que readline attendra un caractère lors de la lecture d’une suite de touches ambiguë (c’est-à-dire qui peut former une suite de touches complète en utilisant l’entrée lue jusqu’à présent, ou accepter une entrée supplémentaire pour compléter une suite de touches plus longue). Si aucune entrée n’est reçue pendant le temps d’attente, readline utilisera la suite la plus courte, mais complète. La valeur est indiquée en milliseconde, donc une valeur de 1000 signifie que readline attendra pendant une seconde une entrée supplémentaire. Si cette variable est configurée à une valeur inférieure ou égale à zéro, ou à une valeur non numérique, readline attendra la saisie d’une autre touche pour décider de la suite de touches à compléter.

mark-directories (On)

Si configurée à On, une barre oblique est ajoutée aux noms de répertoires.

mark-modified-lines (Off)

Si configurée à On, les lignes d'historique qui ont été modifiées seront précédées à l'affichage d'un astérisque (*).

mark-symlinked-directories (Off)

Si configurée à On, une barre oblique est ajoutée aux noms complétés si ce sont des liens symboliques vers des répertoires (selon la valeur de mark-directories).

match-hidden-files (On)

Cette variable, quand elle est configurée à On, conduit readline à faire correspondre des fichiers dont le nom commence par un « . » (fichiers cachés) lors du complètement de noms de fichiers. Si configurée à Off, le « . » du début doit être fourni par l'utilisateur dans le nom de fichier à compléter.

menu-complete-display-prefix (Off)

Si configurée à On, le complètement de menu affiche le préfixe commun à la liste de complétements possibles (qui peut être vide) avant de tourner dans la liste.

output-meta (Off)

Si configurée à On, readline affichera directement les caractères ayant leur huitième bit à 1, plutôt que d'utiliser une suite de caractères de protection avec préfixe méta.

page-completions (On)

Si configurée à On, readline utilise un afficheur de texte interne du type more pour afficher les complètements possibles sur un seul plein écran.

print-completions-horizontally (Off)

Si configurée à On, readline affichera les complètements correspondants triés horizontalement dans l'ordre alphabétique plutôt que verticalement.

revert-all-at-newline (Off)

Si configurée à On, readline annulera toutes les modifications des lignes d'historique avant de s'arrêter quand accept-line est exécuté. Par défaut les lignes d'historique peuvent être modifiées et conservent les listes d'annulation individuelles au fur et à mesure des appels à readline.

show-all-if-ambiguous (Off)

Cela modifie le comportement par défaut des fonctions de complètement. Si configurée à On, les mots qui ont plus d'un complètement possibles conduisent à l'affichage immédiat des correspondances plutôt qu'à l'émission d'une alarme.

show-all-if-unmodified (Off)

Cela modifie le comportement par défaut des fonctions de complètement de façon similaire à show-all-if-ambiguous. Si configurée à On, les mots qui ont plus d'un complètement possible sans aucun complètement partiel possible (les complètements possibles ne partagent pas de préfixe commun) conduisent à l'affichage immédiat des correspondances plutôt qu'à l'émission d'une alarme.

show-mode-in-prompt (Off)

Si configurée à On, ajoute un caractère au début de l’invite indiquant le mode d’édition : Emacs (@), commande Vi (:) ou insertion Vi (+).

skip-completed-text (Off)

Si configurée à On, modifie le comportement par défaut du complètement lors de l'insertion d'une unique correspondance dans la ligne. Elle n'est utilisée que lors d'un complètement effectué au milieu d'un mot. Si elle est activée, readline n'insère pas de caractères de complètement correspondant à des caractères situés après le curseur dans le mot en train d'être complété, ainsi les parties du mots situées après le curseur ne sont pas dupliquées.

visible-stats (Off)

Si configurée à On, un caractère indiquant le type de fichier, comme signalé par stat(2) est ajouté aux noms de fichiers en affichant les complètements possibles.

Constructions conditionnelles de readline¶

Readline implémente un mécanisme inspiré des fonctionnalités de compilation conditionnelle du préprocesseur C qui permet d'effectuer le paramétrage des raccourcis clavier et des variables selon les résultats de tests. Il y a quatre directives d'analyse utilisées.

$if

La structure $if permet de choisir les raccourcis selon le mode d'édition, le terminal utilisé ou l'application utilisant readline. Le texte du test va jusqu'à la fin de la ligne ; aucun caractère n'est nécessaire pour le délimiter.

$if Bash
# Protéger le mot actuel ou le précédant
"\C-xq": "\eb\"\ef\""
$endif

$endif

Cette commande, comme on l'a vu dans l'exemple ci-dessus, termine une commande $if.

$else

Permet d'ajouter des commandes qui seront exécutées si un $if échoue.

$include

Cette directive prend un seul nom de fichier comme argument et y lit les commandes et les raccourcis. Par exemple, la directive suivante lirait le fichier /etc/inputrc :

$include  /etc/inputrc

Recherche¶

Readline fournit des commandes de recherche au sein de l'historique de commandes (consultez HISTORIQUE ci-dessous) des lignes contenant une chaîne donnée. Il y a deux modes de recherche : incrémental et non incrémental.

Les recherches incrémentales commencent avant même que l'utilisateur n'ait terminé de saisir la chaîne recherchée. À chaque caractère saisi, readline affiche l'élément suivant de l'historique qui correspond à la chaîne déjà entrée. Une recherche incrémentale nécessite seulement le nombre de caractères indispensable pour retrouver l'élément d'historique désiré. Les caractères se trouvant dans la variable isearch-terminators servent à terminer une recherche incrémentale. Si aucune valeur n'a été affectée à cette variable, les caractères Échappement (« Escape ») et Contrôle-J terminent une recherche incrémentale. Contrôle-G permet d'interrompre une recherche incrémentale et de restaurer la ligne originale. Lorsque la recherche est finie, l'élément d'historique contenant la chaîne désirée devient la ligne actuelle.

Pour trouver les autres éléments correspondant dans la file d'historique, saisissez selon Contrôle-S ou Contrôle-R. Cela recherchera en avant ou en arrière dans l'historique l'élément suivant correspondant à la chaîne saisie jusque-là. Toute autre suite de touches associée à une commande readline interrompra la recherche et exécutera la commande. Par exemple, un changement de ligne interrompra la recherche et acceptera la ligne, exécutant ainsi la commande de la file d'historique.

Readline se souvient de la dernière chaîne de recherche incrémentale. Si deux Contrôle-R sont tapés sans caractère pour définir une nouvelle recherche de chaîne, toute chaîne mémorisée sera utilisée.

Les recherches non incrémentales lisent la chaîne désirée en entier avant de démarrer la recherche de correspondance dans la liste d'historique. La chaîne peut être saisie par l'utilisateur ou faire partie du contenu de la ligne actuelle.

Noms des commandes readline¶

Ce qui suit est une liste des noms de commandes et les suites de touches auxquelles elles sont associées par défaut. Les noms de commandes sans suite de touche les accompagnant ne sont pas associées par défaut. Dans les descriptions suivantes, le curseur (« point ») se rapporte à la position actuelle du curseur et la marque se rapporte à une position de curseur sauvegardée par la commande set-mark. Le texte entre le curseur et la marque est désigné comme la zone.

Commandes de déplacement¶

beginning-of-line (C-a)

Reculer au début de la ligne actuelle.

end-of-line (C-e)

Avancer à la fin de la ligne.

forward-char (C-f)

Avancer d'un caractère.

backward-char (C-b)

Reculer d'un caractère.

forward-word (M-f)

Avancer jusqu'à la fin du mot suivant. Les mots sont composés de caractères alphanumériques (lettres et chiffres).

backward-word (M-b)

Reculer jusqu'au début du mot actuel ou du précédent. Les mots sont composés de caractères alphanumériques (lettres et chiffres).

shell-forward-word

Avancer jusqu'à la fin du mot suivant. Les mots sont séparés par des métacaractères non protégés de l'interpréteur.

shell-backward-word

Reculer jusqu'au début du mot actuel ou du précédent. Les mots sont séparés par des métacaractères non protégés de l'interpréteur.

clear-screen (C-l)

Effacer l'écran, en laissant la ligne actuelle au sommet de l'écran. S'il y a un argument, rafraîchir la ligne actuelle sans effacer l'écran.

redraw-current-line

Rafraîchir la ligne actuelle.

Commandes de manipulation de l'historique¶

accept-line (changement de ligne, retour chariot)

Valider la ligne, sans se soucier de l'emplacement du curseur. Si la ligne n'est pas vide, l'ajouter à la file d'historique, sous contrôle de la variable HISTCONTROL. Si cette ligne est une ligne d'historique modifiée, restaurer cette dernière.

previous-history (C-p)

Récupérer la commande précédente de la file d'historique, en remontant dans la file.

next-history (C-n)

Récupérer la commande suivante dans la file d'historique, en descendant dans la file.

beginning-of-history (M-<)

Récupérer la première ligne de l'historique.

end-of-history (M->)

Retourner à la fin de l'historique de saisie, c'est-à-dire à la ligne en cours de saisie.

reverse-search-history (C-r)

Rechercher en arrière dans l'historique, en remontant. C'est une recherche incrémentale.

forward-search-history (C-s)

Rechercher en avant dans l'historique, en descendant. C'est une recherche incrémentale.

non-incremental-reverse-search-history (M-p)

Rechercher une chaîne en arrière dans l'historique, en remontant depuis la ligne actuelle, utiliser une recherche non incrémentale pour une chaîne fournie par l'utilisateur.

non-incremental-forward-search-history (M-n)

Rechercher une chaîne en avant dans l'historique, utiliser une recherche non incrémentale pour une chaîne fournie par l'utilisateur.

history-search-forward

Rechercher en avant dans l'historique la chaîne comprise entre le début de la ligne actuelle et la position du curseur. C'est une recherche non incrémentale.

history-search-backward

Rechercher en arrière dans l'historique la chaîne comprise entre le début de la ligne actuelle et la position du curseur. C'est une recherche non incrémentale.

yank-nth-arg (M-C-y)

Insérer, à l'emplacement du curseur, le premier argument de la commande précédente. Généralement, il s'agit du second mot de la ligne précédente. Avec un argument n, insérer le n-ième mot de la commande précédente (les mots sont numérotés à partir de 0). Un argument négatif insère le n-ième mot en partant de la fin de la commande précédente. Une fois que l'argument n est traité, l'argument est extrait comme si le développement d'historique « !n » avait été indiqué.

yank-last-arg (M-., M-_)

Insérer le dernier argument de la commande précédente (le dernier mot de l'élément précédent de la file d'historique). Avec un argument numérique, se comporte exactement comme yank-nth-arg. Les appels successifs à yank-last-arg remontent dans la file d'historique en insérant le dernier mot (ou le mot indiqué par l'argument du premier appel) de chaque ligne tour à tour. Tous les arguments numériques fournis à ces appels successifs déterminent la direction de déplacement dans l'historique. Un argument négatif modifie la direction dans l'historique (en avant ou en arrière). Les outils de développement d'historique sont utilisés pour extraire le dernier mot, comme si le développement d'historique « !$ » avait été indiqué.

shell-expand-line (M-C-e)

Développer, comme le fait l'interpréteur, la ligne actuelle. Cela effectue le développement des alias et d'historique, ainsi que tous les développements de mot de l'interpréteur. Consultez ci-dessous DÉVELOPPEMENT DE L'HISTORIQUE, pour une description détaillée du développement de l'historique.

history-expand-line (M-^)

Effectuer le développement d'historique sur la ligne actuelle. Consultez ci-dessous DÉVELOPPEMENT DE L'HISTORIQUE, pour une description détaillée.

magic-space

Effectuer le développement de l'historique sur la ligne actuelle et insérer une espace. Consultez ci-dessous DÉVELOPPEMENT DE L'HISTORIQUE, pour une description détaillée.

alias-expand-line

Effectuer le développement des alias sur la ligne actuelle. Consultez ALIAS ci-dessus pour une description des développements d'alias.

history-and-alias-expand-line

Effectuer le développement de l'historique et des alias sur la ligne actuelle.

insert-last-argument (M-., M-_)

Un synonyme de yank-last-arg.

operate-and-get-next (C-o)

Valider la ligne actuelle et récupérer la ligne suivante de l'historique pour édition. Tout argument est ignoré.

edit-and-execute-command (C-xC-e)

Appeler un éditeur sur la ligne de commande actuelle et exécuter le résultat comme une commande d'interpréteur. Bash tente d'appeler, dans cet ordre, $VISUAL, $EDITOR et emacs comme éditeur.

Commande d'édition de texte¶

end-of-file (généralement C-d)

Le caractère indiquant la fin de ligne, comme défini, par exemple, par « stty ». Si ce caractère est lu alors qu’aucun caractère n’est sur la ligne, et que le curseur est au début de la ligne, readline l’interprète comme le fin de l’entrée et renvoie EOF.

delete-char (C-d)

Effacer le caractère sous le curseur. Si cette fonction est associée au même caractère que le caractère EOF du terminal, comme c’est souvent le cas avec C-d, consultez les effets dans le paragraphe précédent.

backward-delete-char (Effacement ou « Rubout »)

Effacer le caractère avant le curseur. Lorsque un argument numérique est indiqué, le texte effacé est sauvegardé dans le tampon circulaire.

forward-backward-delete-char

Effacer le caractère sous le curseur, sauf s'il est en fin de ligne, auquel cas le caractère avant le curseur est effacé.

quoted-insert (C-q, C-v)

Ajouter littéralement sur la ligne le caractère saisi suivant. Cela permet d'insérer des caractères comme C-q, par exemple.

tab-insert (C-v TAB)

Insérer un caractère de tabulation.

self-insert (a, b, A, 1, !, ...)

Insérer le caractère mentionné.

transpose-chars (C-t)

Échanger les caractères se trouvant devant et sous le curseur. Le curseur est avancé d'un caractère. À la fin d'une ligne, les caractères échangés sont les deux précédents. Les arguments négatifs n'ont aucun effet.

transpose-words (M-t)

Déplace le mot avant le curseur au-delà du mot après le curseur et déplace aussi le curseur sur ce mot. Si le curseur est à la fin de la ligne, cela échange les deux derniers mots de la ligne.

upcase-word (M-u)

Transformer le mot actuel (ou le suivant) en majuscules. Avec un argument négatif, agir sur le mot précédent mais ne pas déplacer le curseur.

downcase-word (M-l)

Transformer le mot actuel (ou le suivant) en minuscules. Avec un argument négatif, agir sur le mot précédent mais ne pas déplacer le curseur.

capitalize-word (M-c)

Passer en majuscule l'initiale du mot actuel (ou du suivant). Avec un argument négatif, agir sur le mot précédent mais ne pas déplacer le curseur.

overwrite-mode

Basculer en mode d'écrasement. Avec un argument numérique explicite strictement positif, bascule en mode d'écrasement. Avec un argument numérique explicite négatif ou nul, bascule en mode d'insertion. Cette commande n'affecte que le mode emacs ; le mode vi écrase de façon différente. Chaque appel à readline() démarre en mode d'insertion. En mode d'écrasement, les caractères associés à self-insert remplacent le texte sous le curseur plutôt que de déplacer le texte vers la droite. Les caractères associés à backward-delete-char remplacent le caractère avant le curseur par une espace. Par défaut, cette commande n'est pas associée.

Effacement et récupération¶

kill-line (C-k)

Effacer le texte depuis la position du curseur jusqu'à la fin de la ligne.

backward-kill-line (C-x Effacement)

Effacer en arrière jusqu'au début de ligne.

unix-line-discard (C-u)

Effacer le texte entre le début de la ligne et la position du curseur. Le texte est sauvegardé dans le tampon circulaire.

kill-whole-line

Effacer toute la ligne sans tenir compte de la position du curseur.

kill-word (M-d)

Effacer le texte entre le curseur et la fin du mot actuel ou, si entre des mots, jusqu'à la fin du mot suivant. Les limites des mots sont identiques à celles utilisées par forward-word.

backward-kill-word (M-Effacement)

Effacer le mot sous le curseur. Les limites de mots sont identiques à celles utilisées par backward-word.

shell-kill-word (M-d)

Effacer le texte entre le curseur et la fin du mot actuel ou, si entre des mots, jusqu'à la fin du mot suivant. Les limites des mots sont identiques à celles utilisées par shell-forward-word.

shell-backward-kill-word (M-Effacement)

Effacer le mot sous le curseur. Les limites de mots sont identiques à celles utilisées par shell-backward-word.

unix-word-rubout (C-w)

Effacer le mot sous le curseur, en utilisant une espace blanche comme limite de mot. Le texte effacé est sauvegardé dans le tampon circulaire.

unix-filename-rubout

Effacer le mot sous le curseur, en utilisant l'espace blanche et la barre oblique comme limites de mot. Le texte supprimé est sauvegardé dans le tampon circulaire.

delete-horizontal-space (M-\)

Effacer toutes les espaces blanches et les tabulations autour du curseur.

kill-region

Effacer le texte de la zone actuelle.

copy-region-as-kill

Copier le texte de la zone vers le tampon circulaire.

copy-backward-word

Copier le mot précédant le curseur dans le tampon circulaire. Les limites de mots sont identiques à celles de backward-word.

copy-forward-word

Copier le mot suivant le curseur dans le tampon circulaire. Les limites de mots sont identiques à celles de forward-word.

yank (C-y)

Récupérer le texte au sommet du tampon circulaire à la position du curseur dans le tampon.

yank-pop (M-y)

Exécuter une rotation du tampon circulaire et récupérer le texte situé à son nouveau sommet. Cela ne fonctionne qu'après yank ou yank-pop.

Arguments numériques¶

digit-argument (M-0, M-1, ..., M--)

Ajouter ce chiffre à l'argument en cours de rédaction ou créer un nouvel argument. M-- crée un argument négatif.

universal-argument

Il s'agit d'une autre façon d'indiquer un argument. Si cette commande est suivie d'un ou plusieurs chiffres facultativement précédés d'un signe moins, ces chiffres définissent l'argument. Si la commande est suivie de chiffres, une nouvelle exécution de universal-argument termine l'argument numérique, mais est ignorée dans les autres cas. Par exception, si cette commande est suivie immédiatement par un caractère qui n'est ni un chiffre ni le signe moins, le compteur d'arguments de la commande suivante est multiplié par 4. Le compteur d'arguments est initialement à un, donc la première exécution de cette commande amène le compteur d'arguments à quatre, une seconde fois porte le compteur d'arguments à seize et ainsi de suite.

Complètement¶

complete (TAB)

Essayer d'effectuer un complètement du texte situé avant le curseur. Bash effectue le complètement en considérant tour à tour le texte comme une variable (s'il commence par $), un nom d'utilisateur (s'il commence par ~), un nom de machine (s'il commence par @) ou une commande (y compris les alias et les fonctions). Si aucun ne correspond, un complètement de nom de fichier est essayé.

possible-completions (M-?)

Afficher les complètements possibles pour le texte situé avant le curseur.

insert-completions (M-*)

Insérer avant le curseur l'ensemble des complètements qui auraient été produits par possible-completions.

menu-complete

Analogue à complete, mais en remplaçant le mot à compléter par une seule correspondance de la liste des complètements possibles. Des exécutions répétées de menu-complete parcourent la liste des complètements possibles, en insérant chaque correspondance tour à tour. À la fin de la liste des complètements, une alarme est émise (selon la configuration de bell-style) et le texte original est restauré. Un argument de n déplace de n positions dans la liste des correspondances. Un argument négatif peut être utilisé pour revenir en arrière dans la liste. Cette commande est destinée à être associée à la touche TAB, mais ne l'est pas par défaut.

menu-complete-backward

Identique à menu-complete, mais se déplace en arrière dans la liste des complètements possibles, comme si un argument négatif avait été passé à menu-complete. Cette commande n'est associée à aucune touche par défaut.

delete-char-or-list

Effacer le caractère sous le curseur sauf au début ou en fin de ligne (comme delete-char). En fin de ligne, se comporte comme possible-completions. Cette commande n'est associée à aucune touche par défaut.

complete-filename (M-/)

Essayer le complètement des noms de fichiers sur le texte situé avant le curseur.

possible-filename-completions (C-x /)

Afficher les complètements possibles du texte situé avant le curseur, traité comme un nom de fichier.

complete-username (M-~)

Essayer le complètement sur le texte situé avant le curseur, en le traitant comme un nom d'utilisateur.

possible-username-completions (C-x ~)

Afficher les complètements possibles du texte situé avant le curseur, en le traitant comme un nom d'utilisateur.

complete-variable (M-$)

Essayer le complètement sur le texte situé avant le curseur, en le traitant comme une variable de l'interpréteur.

possible-variable-completions (C-x $)

Afficher les complètements possibles du texte situé avant le curseur, en le traitant comme une variable de l'interpréteur.

complete-hostname (M-@)

Essayer le complètement sur le texte situé avant le curseur, en le traitant comme un nom de machine.

possible-hostname-completions (C-x @)

Afficher les complètements possibles du texte situé avant le curseur, en le traitant comme un nom de machine.

complete-command (M-!)

Essayer le complètement sur le texte situé avant le curseur, en le traitant comme un nom de commande. Le complètement des commandes essaie de faire correspondre le texte, dans cet ordre, aux alias, mots réservés, fonctions de l'interpréteur, commandes internes de l'interpréteur et finalement les noms de fichiers exécutables.

possible-command-completions (C-x !)

Afficher les complètements possibles du texte situé avant le curseur, en le traitant comme un nom de commande.

dynamic-complete-history (M-TAB)

Essayer le complètement du texte situé avant le curseur, en le comparant aux lignes de la file d'historique lui correspondant pour les complètements possibles.

dabbrev-expand

Essayer le menu de complètement du texte situé avant le curseur, en le comparant aux lignes de la file d'historique lui correspondant pour les complètements possibles.

complete-into-braces (M-{)

Effectuer un complètement en noms de fichiers et insérer la liste des complètements possibles entre accolades afin que la liste soit exploitable par l'interpréteur (consultez Développement des accolades ci-dessus).

Macros clavier¶

start-kbd-macro (C-x ()

Démarrer la mémorisation dans la macro en cours des caractères tapés.

end-kbd-macro (C-x ))

Arrêter la mémorisation dans la macro en cours des caractères saisis et conserver la définition.

call-last-kbd-macro (C-x e)

Réexécuter la dernière macro définie, en agissant comme si les caractères contenus dans cette macro étaient saisis au clavier.

print-last-kbd-macro ()

Afficher la dernière macro de clavier définie, mise en forme de façon à être incorporée dans un fichier inputrc.

Divers¶

re-read-init-file (C-x C-r)

Lire le contenu du fichier inputrc et prendre en compte tous raccourcis ou affectations de variables qui s'y trouvent.

abort (C-g)

Abandonner l'édition en cours et émettre une alarme de terminal (selon la configuration de la variable bell-style).

do-uppercase-version (M-a, M-b, M-x, ...)

Si le caractère x précédé de Méta est en minuscule, exécuter la commande qui est associée aux caractères majuscules correspondants.

prefix-meta (ESC)

Considérer le prochain caractère saisi comme un Méta. ESC f est équivalent à Meta-f.

undo (C-_, C-x C-u)

Fonction d'annulation incrémentale, chaque ligne étant mémorisée séparément.

revert-line (M-r)

Annuler toutes les modifications sur cette ligne. C’est équivalent à répéter undo suffisamment de fois pour ramener la ligne à son état initial.

tilde-expand (M-&)

Effectuer le développement du tilde sur le mot actuel.

set-mark (C-@, M-<space>)

Placer la marque à la position actuelle du curseur. Si un argument numérique est fourni, la marque est posée à la position correspondante.

exchange-point-and-mark (C-x C-x)

Échanger le curseur et la marque. La position actuelle du curseur est configurée à la position sauvegardée précédemment et l'ancienne position du curseur est mémorisée comme la marque.

character-search (C-])

Un caractère est lu et le curseur déplacé à l'occurrence suivante de ce caractère. Un argument négatif recherche les occurrences précédentes.

character-search-backward (M-C-])

Un caractère est lu et le curseur déplacé à l'occurrence précédente de ce caractère. Un argument négatif recherche les occurrences suivantes.

skip-csi-sequence

Lire suffisamment de caractères pour englober une suite multitouche comme celles définies pour des touches comme Début et Fin. De telles suites commencent par un indicateur de suite de contrôle (« control sequence indicator » ou CSI), habituellement ESC-[. Si cette suite est associée à "\[", les touches qui produisent de telles suites n'auront pas d'effet à moins d'être explicitement associées à une commande readline, au lieu d'insérer des caractères parasites dans le tampon d'édition. N'est associée à aucune touche par défaut, mais est souvent associée à ESC-[.

insert-comment (M-#)

Sans argument numérique, la valeur de la variable comment-begin de readline est insérée au début de la ligne actuelle. Si un argument numérique est fourni, cette commande agit comme une bascule : si les caractères du début de ligne ne correspondent pas à la valeur de comment-begin, la valeur est insérée, sinon, les caractères de comment-begin sont effacés du début de la ligne. Dans les deux cas, la ligne est acceptée comme si un changement de ligne avait été saisi. La valeur par défaut de comment-begin conduit cette commande à transformer la ligne actuelle de l'interpréteur en commentaire. Si un argument numérique conduit à l'effacement du caractère de commentaire, la ligne sera exécutée par l'interpréteur.

glob-complete-word (M-g)

Le mot avant le curseur est traité comme un motif pour un développement de chemin, avec un astérisque implicitement ajouté. Ce motif est utilisé pour produire une liste de noms de fichiers correspondants pour de possibles complètements.

glob-expand-word (C-x *)

Le mot précédant le curseur est considéré comme un motif de développement de chemin et la liste des fichiers correspondants est insérée à sa place. Si un argument numérique est fourni, un astérisque est ajouté avant le développement du chemin.

glob-list-expansions (C-x g)

La liste des développements qui auraient été produits par glob-expand-word est affichée et la ligne est rafraîchie. Si un argument numérique est fourni, un astérisque est ajouté devant le développement du chemin.

dump-functions

Afficher toutes les fonctions et leurs raccourcis clavier sur le flux de sortie de readline. Si un argument numérique est fourni, la sortie est mise en forme de façon à être incorporée dans un fichier inputrc.

dump-variables

Afficher toutes les variables readline modifiables et leurs valeurs sur le flux de sortie de readline. Si un argument numérique est fourni, la sortie est mise en forme de façon à être incorporée dans un fichier inputrc.

dump-macros

Afficher toutes les suites de touches readline associées à des macros et les chaînes auxquelles elles correspondent. Si un argument numérique est fourni, la sortie est mise en forme de façon à être incorporée dans un fichier inputrc.

display-shell-version (C-x C-v)

Afficher des informations sur la version actuelle de bash.

Complètement programmable¶

Lorsqu'un complètement de mot est tenté pour un argument d'une commande pour laquelle une spécification de complètement a été définie en utilisant la commande interne complete (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous), les outils de complètement programmables sont appelés.

En premier lieu, le nom de la commande est identifié. Si le mot de commande est vide (complètement essayé en début de ligne vide), toutes les spécifications de complètement définies par l'option -E de complete sont utilisées. Si une spécification de complètement a été définie pour cette commande, elle est utilisée pour produire la liste des complètements possibles pour le mot. Si le mot de commande est un chemin d'accès complet, on cherche en premier lieu une spécification de complètement pour le chemin d'accès complet. Si aucune spécification de complètement n'est trouvée pour le chemin d'accès complet, une tentative est effectuée pour trouver une spécification de complètement pour la partie située après la barre oblique finale. Si ces recherches ne donnent aucun résultat sous forme de spécification de complètement, toutes les spécifications de complètement définies par l'option -D de complete sont utilisées par défaut.

Une fois qu'une spécification de complètement a été trouvée, elle est utilisée pour produire la liste des mots correspondants. Si aucune spécification de complètement n'est trouvée, le complètement par défaut de bash, tel que décrit ci-dessus dans Complètement est effectué.

Tout d'abord, les actions définies par la spécification de complètement sont utilisées. Seules les correspondances préfixées par le mot à compléter sont renvoyées. Lorsque l'option -f ou -d est utilisée pour le complètement des noms de fichiers ou de répertoire, la variable de l'interpréteur FIGNORE est utilisée pour filtrer les correspondances.

Tous les complètements indiqués par le motif de développement de chemin de l'option -G sont ensuite produits. Il n'est pas nécessaire que les mots produits par le motif correspondent au mot à compléter. La variable de l'interpréteur GLOBIGNORE n'est pas utilisée pour filtrer les correspondances, mais la variable FIGNORE est utilisée.

Ensuite, la chaîne indiquée comme argument à l'option -W est prise en compte. Cette chaîne est tout d'abord découpée en utilisant les caractères de la variable spéciale IFS comme délimiteurs. Les protections de l'interpréteur sont prises en compte. Chaque mot est ensuite développé en utilisant les développements d'accolades, du tilde, des paramètres et des variables, de même que la substitution de commande et le développement arithmétique comme décrit ci-dessus dans DÉVELOPPEMENTS. Les résultats sont découpés en utilisant les règles décrites ci-dessus dans Découpage en mots. Les résultats du développement sont comparés au mot à compléter en considérant ce dernier comme préfixe et les mots correspondants deviennent les complètements possibles.

Après la création de ces correspondances, toute fonction de l'interpréteur ou commande indiquée avec les options -F et -C est appelée. Lorsque la commande ou la fonction est appelée, les variables COMP_LINE , COMP_POINT , COMP_LINKEY , et COMP_POINTYPE se voient affectées de valeurs comme décrit ci-dessus dans Variables de l'interpréteur. Si une fonction de l'interpréteur est appelée, les variables COMP_WORDS et COMP_CWORD sont également créées. Lorsqu'une fonction ou une commande est appelée, le premier argument ($1) est le nom de la commande dont les arguments doivent être complétés, le deuxième argument ($2) est le mot à compléter et le troisième argument ($3) est le mot précédant celui devant être complété sur la ligne de commande actuelle. Aucun filtrage des complètements produits pour le mot à compléter n'est effectué ; la fonction ou la commande a toute liberté dans la production des correspondances.

Toute fonction indiquée avec -F est appelée en premier. La fonction peut utiliser tous les outils de l'interpréteur, incluant la commande interne compgen décrite ci-dessous, pour produire les correspondances. Elle doit mettre les complètements possibles dans la variable tableau COMPREPLY, une par élément de tableau.

Ensuite, toute commande indiquée avec l'option -C est appelée dans un environnement équivalent à la substitution de commande. Elle devrait afficher une liste des complètements possibles, une par ligne, sur la sortie standard. Si nécessaire, une contre-oblique peut être utilisée pour protéger un caractère de changement de ligne.

Après la création de tous les complètements possibles, tout filtre, indiqué avec l'option -X, est appliqué à la liste. Ce filtre est un motif comme dans le développement des chemins ; un & dans le motif est remplacé par le texte du mot en cours de complètement. Un & littéral peut être protégé par une contre-oblique ; la contre-oblique est supprimée avant la tentative de mise en correspondance. Tout complètement qui correspond au motif sera supprimé de la liste. Un ! au début du motif provoque la négation de ce motif ; dans ce cas, tout complètement ne correspondant pas au motif sera supprimé de la liste.

Finalement, tous préfixe et suffixe indiqués avec les options -P et -S sont ajoutés à chacun des éléments de la liste de complètement et le résultat est renvoyé au programme de complètement de readline comme étant la liste des complètements possibles.

Si les opérations précédemment appliquées ne produisent aucune correspondance et si l'option -o dirnames a été fournie à complete lorsque la spécification de complètement a été définie, le complètement des noms de répertoire est tenté.

Si l'option -o plusdirs a été fournie à complete lors de la définition de la spécification de complètement, le complètement des noms de répertoires est tenté et toute correspondance est ajoutée aux résultats des autres actions.

Par défaut, si une spécification de complètement est trouvée, tout ce qu'elle produit est renvoyé au programme de complètement comme un jeu complet des complètements possibles. Les complètements par défaut de bash ne sont pas tentés et le complètement de fichiers par défaut de readline est désactivé. Si l'option -o bashdefault a été fournie à complete lors de la définition de la spécification de complètement, les complètements par défaut de bash sont tentés si la spécification de complètement ne produit aucune correspondance. Si l'option -o default a été fournie à complete lors de la définition de la spécification de complètement, le complètement par défaut de readline sera effectué si la spécification de complètement (et, si tentés, les complètements par défaut de bash) ne produit aucune correspondance.

Lorsqu'une spécification de complètement indique qu'un complètement de nom de répertoire est souhaité, les fonctions de complètement programmable forcent readline à ajouter une barre oblique pour compléter les noms qui sont des liens symboliques vers des répertoires, selon la valeur de la variable mark-directories de readline, indépendamment du paramétrage de la variable mark-symlinked-directories de readline.

La modification dynamique des complètements est également possible. C'est particulièrement utile combiné avec un complètement par défaut indiqué à l'aide de complete -D. Les fonctions de l'interpréteur exécutés comme gestionnaires de complètement permettent d'annoncer que le complètement devrait être réessayé en renvoyant un état final de 124. Si une fonction de l'interpréteur renvoie 124, et modifie la spécification de complètement associée à la commande sur laquelle le complètement est essayé (fournie comme premier argument quand la fonction est exécutée), le complètement programmable recommence depuis le début, en essayant de trouver une nouvelle spécification de complètement pour cette commande. Un jeu de complètements peut ainsi être construit dynamiquement lorsque le complètement est essayé, plutôt que d'être chargé entièrement au début.

Par exemple, en supposant l'existence d'une bibliothèque de spécifications de complètement, chacune conservée dans un fichier correspondant au nom de la commande, la fonction de complètement par défaut suivante chargerait les complètements de façon dynamique :

_completion_loader()
{
. "/etc/bash_completion.d/$1.sh" >/dev/null 2>&1 && return 124
}
complete -D -F _completion_loader -o bashdefault -o default

Indicateur d'événement¶

Un indicateur d'événement est une référence à un élément ligne de commande dans la file d'historique. Sauf s'il s'agit d'une référence absolue, les événements sont relatifs à la position actuelle dans la file d'historique.

!

Débute une substitution d'historique, sauf s'il est suivi par un blanc, changement de ligne, retour chariot, = ou ( (lorsque l'option d'interpréteur extglob est activée en utilisant la commande interne shopt).

!n

Se rapporte à la ligne de commande n.

!-n

Se rapporte à la commande actuelle moins n.

!!

Se rapporte à la commande précédente. C'est un synonyme de « !-1 ».

!chaîne

Se rapporte à la commande la plus récente précédant la position actuelle dans la liste d'historique commençant par chaîne.

!?chaîne[?]

Se rapporte à la commande la plus récente précédant la position actuelle dans la liste d'historique contenant chaîne. Le ? final peut être omis si chaîne est immédiatement suivie d'un changement de ligne.

^chaîne_1^chaîne_2^

Substitution rapide. Répéter la commande précédente en remplaçant chaîne_1 par chaîne_2. Équivalent à « !!:s/chaîne_1/chaîne_2/ » (consultez Modificateurs ci-dessous).

!#

La ligne entière tapée jusqu'à présent.

Indicateurs de mots¶

Ces indicateurs servent à sélectionner les mots désirés dans un événement. Un : sépare l'indicateur d'événements de l'indicateur de mot. On peut l'omettre si l'indicateur de mot commence par ^, $, *, - ou %. Les mots sont numérotés depuis le début de la ligne, le premier étant noté 0 (zéro). Les mots sont insérés dans la ligne actuelle, séparés par des espaces.

0 (zéro)

Le zéro-ième mot. Pour l'interpréteur, c'est le nom de la commande.

n

Le n-ième mot.

^

Le premier argument, c'est-à-dire le mot 1.

$

Le dernier mot. C’est généralement le dernier argument, mais qui sera développé en zéro-ième mot s’il n’y a qu’un seul mot sur la ligne.

%

Le mot correspondant à la recherche « ?chaîne? » la plus récente.

x-y

Un intervalle de mots, « -y » permet d'abréger « 0-y ».

*

Tous les mots sauf le zéro-ième. C'est un synonyme pour « 1-$ ». Il n'est pas erroné d'utiliser * s'il n'y a qu'un mot dans l'événement ; la chaîne vide est renvoyée dans ce cas.

x*

Abréviation de x-$.

x-

Abréviation de x-$ comme x*, mais sans le dernier mot.

Si un indicateur de mot est fourni sans indication d'événement, la dernière commande est utilisée.

Modificateurs¶

Après un indicateur de mot facultatif, une suite d'un ou plusieurs des modificateurs suivants peut apparaître, chacun précédé par un « : ».

h

Éliminer la fin du chemin d'accès, en ne gardant que le début.

t

Supprimer tout le début d'un chemin d'accès, en ne gardant que la fin.

r

Supprimer un suffixe final de la forme .xxx, en ne gardant que le nom de base.

e

Supprimer tout sauf le suffixe final.

p

Afficher la nouvelle commande sans l'exécuter.

q

Protéger les mots substitués, pour éviter des substitutions futures.

x

Protéger les mots substitués comme avec q, mais avec séparation des mots aux blancs et changements de ligne.

s/ancien/nouveau/

Remplacer par nouveau la première occurrence de ancien sur la ligne d'événement. Tout délimiteur peut être utilisé à la place de /. Le dernier délimiteur est facultatif si c'est le dernier caractère de la ligne d'événement. Le délimiteur peut être protégé dans ancien et nouveau avec une seule contre-oblique. Si & apparaît dans nouveau, il est remplacé par ancien. Une seule contre-oblique protégera le &. Si ancien est NULL, il est configuré au dernier ancien substitué ou si aucune substitution n'a eu lieu précédemment, à la dernière chaîne dans une recherche !?chaîne[?].

&

Répéter la substitution précédente.

g

Appliquer les modifications sur toute la ligne d'événements. C'est utilisé conjointement à « :s » (par exemple « :gs/ancien/nouveau/ ») ou « :& ». Si utilisé avec « :s », tout délimiteur peut être utilisé à la place de / et le dernier délimiteur est facultatif si c'est le dernier caractère de la ligne d'événements. Un a peut être utilisé en tant que synonyme de g.

G

Appliquer le modificateur « s » suivant une fois à tous les mots de la ligne d'événements.