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 code de retour ou 128+n si la commande a été terminée par le signal n.

Pipelines¶

Un pipeline est une suite d'une ou plusieurs commandes séparées par un des opérateurs de contrôle | ou |&. Le format d'un pipeline 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_1 (consultez REDIRECTIONS ci-dessous). Si |& est l'opérateur de pipeline, 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 spécifiée par la commande_1.

Le code de retour d'un pipeline est celui de la dernière commande, à moins que l'option pipefail soit activée. Si pipefail est activée, le code de retour du pipeline est celui de la dernière commande (la plus à droite) se terminant avec un code de retour 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 un pipeline, le code de retour de ce pipeline sera la négation logique du code de retour tel que décrit ci-dessus. Si un pipeline est exécuté de façon synchrone, l'interpréteur attend que toutes les commandes du pipeline soient terminées avant de renvoyer une valeur.

Si le mot réservé time précède un pipeline, l'interpréteur rapporte le temps écoulé ainsi que temps utilisateur et le temps système consommés par son exécution quand le pipeline 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 valeur de la variable TIMEFORMAT est 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 apparaître seul comme le seul mot dans une commande simple. Dans ce cas, l'interpréteur affiche le temps utilisateur et système total consommé par l'interpréteur et ses enfants. La variable TIMEFORMAT indique le format des informations de temps.

Toute commande dans un pipeline multicommande, où les tubes sont créés, est exécutée dans un sous-interpréteur qui est un processus séparé. Consultez ENVIRONNEMENT D'EXÉCUTION DES COMMANDES pour une description des sous-interpréteurs et d'un environnement de sous-interpréteur. Si l'option lastpipe est activée en utilisant la commande interne shopt (consultez la description de shopt ci-dessous), et que le contrôle des tâches est désactivé, le dernier élément d'un pipeline peut être exécuté par le processus de l'interpréteur.

Listes¶

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

Parmi ces opérateurs de liste, && et || ont une priorité identique, suivis de ; 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 le code de retour est 0. Elles sont désignées comme des commandes asynchrones. Les commandes séparées par un ; sont exécutées successivement, l'interpréteur attend que chaque commande se termine tour à tour. La valeur renvoyée est le code de retour de la dernière commande exécutée.

Les listes ET et OU sont des suites d'un ou plusieurs pipelines séparés 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 zéro comme code de retour (succès).

Une liste OU a la forme

commande_2 est exécutée si, et seulement si, commande_1 renvoie un code de retour différent de zéro. La valeur renvoyée par des listes ET et OU est le code de retour 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 peut être séparée du reste de la commande par un ou plusieurs changements de ligne, et peut ê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 pour une description d'un environnement de sous-interpréteur). Les affectations de variables et les commandes internes qui affectent l'environnement de l'interpréteur n'ont plus d'effet une fois que la commande se termine. La valeur renvoyée est le code de retour final de la liste.

{ liste; }

La liste est exécutée avec l'environnement de l'interpréteur en cours. La liste doit se terminer par un changement de ligne ou un point-virgule. Cette construction est connue sous le nom de commandes groupées. La valeur renvoyé est le code de retour 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 arithmétique 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, le code de retour est 0 ; sinon le code de retour est 1. L'expression est sujette aux mêmes développements que si elle était entre guillemets doubles, mais les caractères guillemet double qui ne sont pas échappés dans l'expression ne sont pas traités expressément et sont supprimés. Comme cela peut aboutir potentiellement à des chaînes vides, cette commande les traite comme des expressions qui s'évaluent à 0.

[[ expression ]]

Évalue l'expression conditionnelle expression et renvoie un code deretour de zéro (vrai) ou une valeur différente de zéro (faux). Les conditions sont composées de primitives décrites ci-dessous dans EXPRESSIONS CONDITIONNELLES. Les mots entre [[ et ]] ne sont sujets ni au découpage en mots, ni au développement des chemins. L'interpréteur effectue 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 sur ces mots. 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 capitale/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. Si une partie du motif est protégée, la partie protégée est mise en correspondance en tant que chaîne : chaque caractère dans la partie protégée correspond à lui-même, au lieu d'avoir une signification particulière de correspondance de motif.

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 POSIX et est mise en correspondance en conséquence (en utilisant les interfaces POSIX regcomp et regexec habituellement décrites dans 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 par 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 des caractères alphabétiques.

Si une partie du motif est protégée, cette partie est mise en correspondance littéralement comme ci-dessus. Si le motif est stocké dans une variable de l'interpréteur, la protection de développement de variable force le motif entier à correspondre littéralement. Traitez prudemment les expressions entre crochets des expressions rationnelles, car les caractères de protection et de motifs habituels perdent leur signification entre crochets.

La correspondance réussit si le motif correspond à n'importe quelle partie de la chaîne. Ancrer le motif avec les opérateurs d'expression rationnelle ^ et $ pour le forcer à correspondre à la totalité de la chaîne.

La variable de type tableau BASH_REMATCH enregistre quelle partie de la chaîne correspond au motif. L'élément de BASH_REMATCH d'indice 0 contient la partie de la chaîne correspondant à la totalité de l'expression rationnelle. Les sous-chaînes correspondant aux sous-expressions entre parenthèses dans l'expression rationnelle sont sauvegardées avec les indices restants de BASH_REMATCH. L'élément de BASH_REMATCH d'indice n est la partie de la chaîne correspondant à la n-ième sous-expression entre parenthèses. La configuration de BASH_REMATCH par bash est de portée globale ; la déclarer comme une variable locale mènera à des résultats inattendus.

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

Développer d'abord la liste de mots suivant in, produisant une liste d'éléments. Ensuite, 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). La valeur renvoyée est le code de retour 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 le code de retour 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 à 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 le code de retour de la dernière commande dans liste qui est exécutée ou une valeur différente de zéro si l'une des expressions est non valable.

Utiliser les commandes internes break et continue (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous) pour contrôler l'exécution de la boucle.

select nom [ in mot ] ; do liste ; done

Développer d'abord la liste de mots suivant in, produisant une liste d'éléments et afficher l'ensemble des mots développés sur la sortie d'erreur standard, chacun précédé par un nombre. Si in mot est omis, afficher les paramètres positionnels (consultez PARAMÈTRES ci-dessous). select affiche alors l'invite PS3 et lit une ligne depuis l'entrée standard. Si la ligne est constituée d'un nombre correspondant à l'un des mots affichés, alors select affecte la valeur nom à ce mot. Si la ligne est vide, select affiche les mots et l'invite à nouveau. Si une fin de fichier (EOF) est lue, select se termine et renvoie 1. Toute autre valeur définit nom à 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 exécutée. Le code de retour de select est le code de retour 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 procédant du premier au dernier, en utilisant les règles de mise en correspondance décrites dans Motifs génériques ci-dessous. Une liste de motifs est un ensemble d'un ou plusieurs motifs séparés par |, et l'opérateur ) termine la liste de motifs. Le mot est développé en utilisant le développement du tilde, le développement des paramètres et des variables, le développement 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, le développement arithmétique, la substitution de commande, la substitution de processus et la suppression des protections. 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. Une clause est une liste de motifs et une liste associée.

Quand une correspondance est trouvée, case exécute la liste correspondante. Si l'opérateur ;; termine la clause case, la commande case se termine après la première correspondance. L'utilisation de ;& à la place de ;; fait que l'exécution se poursuit avec la liste associée à la liste suivante de motifs. L'utilisation de ;;& à la place de ;; fait que l'interpréteur teste la liste suivante de motifs de l'instruction, si elle existe, et exécute la liste associée si la correspondance réussit, poursuivant l'exécution de l'instruction de case comme si la liste de motifs n'avait pas trouvé de correspondance. Le code de retour est zéro si aucun motif ne correspond.

Sinon, c'est le code de retour de la dernière commande exécutée de la dernière liste traitée.

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

La liste du if est exécutée. Si son code de retour est zéro, la liste du then est exécutée. Sinon, chaque liste des elif est exécutée tour à tour et si son code de retour est zéro, la liste du then associé est exécutée et la commande se termine. Sinon, la liste du else, si présente, est exécutée. Le code de retour est celui 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 liste-2 tant que la dernière commande de la liste liste-1 renvoie un code de retour 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 code de retour différent de zéro. Le code de retour des commandes while et until est le code de retour 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.

La syntaxe d'un coprocessus est :

Cela crée un coprocessus nommé NOM. commande peut être une commande simple ou une commande composée (voir plus haut). NOM est le nom d'une variable de l'interpréteur. Si NOM n'est pas fourni, le nom par défaut est COPROC.

Le format recommandé à utiliser pour un coprocessus est le suivant :

Cette forme est préférée parce que des commandes simples font que le coprocessus est toujours appelé COPROC, et elle est plus simple à utiliser et plus complète que les autres commandes composées.

Si commande est une commande composée, NOM est optionnel. Le mot suivant coproc détermine si ce mot est interprété comme un nom de variable : il est interprété comme NOM si ce n'est pas un mot réservé qui introduit une commande composée. Si commande est une commande simple, NOM n'est pas permis ; cela est destiné à éviter une confusion entre NOM et le premier mot de la 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ée 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ée 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 en utilisant les développements standards de mot. Les descripteurs de fichier autres que ceux créés pour exécuter des substitutions de commande et de processus, 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 NOM_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. La valeur renvoyée par un coprocessus est le code de retour 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 :

nomfonction () commande-composée [redirection]

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

Cela définit une fonction possédant le nomfonction 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. Si le mot réservé function est utilisé, mais que les parenthèses ne sont pas fournies, les accolades sont recommandées. La commande-composée est exécutée chaque fois que nomfonction est indiqué comme nom d'une commande normale. En mode POSIX, nomfonction doit être un nom valable d'interpréteur et ne peut pas être le nom d’une des commandes internes spéciales de POSIX (« special builtins »). En mode par défaut, un nom de fonction peut être n'importe quel mot de l'interpréteur non protégé qui ne contient pas de $.

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.

Le code de retour 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, le code de retour est celui de la dernière commande exécutée dans le corps de la fonction (consultez FONCTIONS ci-dessous).

Traductions de chaîne¶

Une chaîne entre guillemets doubles précédée d'un symbole dollar ($"chaîne") conduit à la traduction de la chaîne selon les paramètres linguistiques régionaux en vigueur. L'infrastructure de gettext parcourt la chaîne et effectue la traduction, en utilisant les variables de l'interpréteur LC_MESSAGES, TEXTDOMAINDIR et TEXTDOMAIN. Si les paramètres linguistiques régionaux actuels sont C ou POSIX, s'il n'y a pas de traduction disponible ou si la chaîne n'est pas traduite, le symbole dollar est ignoré et la chaîne est traitée comme entre guillemets doubles comme décrit ci-dessus. C'est une forme de double protection, ainsi la chaîne demeure entre guillemets doubles par défaut qu'elle soit ou non traduite et remplacée. Si l'option noexpand_translation est activée en utilisant la commande interne shopt, les chaînes traduites sont protégées par des guillemets simples au lieu de guillemets doubles. Consultez la description de shopt ci-dessous dans COMMANDES INTERNES DE L'INTERPRÉTEUR.

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 à partir des arguments de l'interpréteur lors de son invocation. Ils peuvent être affectés à nouveau avec la commande interne set. Les paramètres positionnels ne peuvent pas être affectés par des instructions d'affectation. 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). Sans accolades, un chiffre suivant $ ne peut faire référence qu'à un des neuf paramètres positionnels ($1-$9), ou au paramètre spécial $0 (voir le paragraphe suivant).

Paramètres spéciaux¶

L'interpréteur traite plusieurs paramètres spécifiquement. Ces paramètres peuvent uniquement être référencés, il n'est pas permis de leur affecter une valeur. Les paramètres spéciaux sont indiqués par un des caractères suivants.

*

($*) Se développe en l'ensemble des paramètres positionnels, en 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ù les développements de mots sont réalisés, ces mots sont soumis à d’autres découpages en mots 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 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 l'ensemble des paramètres positionnels, en commençant par le premier. Dans les contextes où le découpage en mots est réalisé, chaque paramètre positionnel se développe en un mot séparé ; si ces mots ne sont pas entre des guillemets doubles, ils sont sujets au découpage en mots. Dans les contextes où il n'y a pas de découpage en mots, tels que la partie valeur d'une instruction d'affectation, chaque paramètre positionnel se développe en un mot distinct séparé par des espaces. 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).

#

($#) Se développe au nombre de paramètres positionnels, en base décimale.

?

($?) Se développe au code de retour de la dernière commande exécutée.

-

($-) Se développe en indicateurs des options actuelles indiquées durant l'appel par la commande interne set ou celles définies par l'interpréteur lui-même (comme avec l'option -i).

$

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

!

($!) Se développe 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

($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 du fichier utilisé pour appeler bash, comme indiqué par l'argument zéro.

Variables de l'interpréteur¶

L'interpréteur définit les variables suivantes :

_

($_, un tiret bas) Cela a plusieurs significations selon le contexte. Au lancement de l'interpréteur, _ contient le chemin d'accès 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. Il se développe ensuite en dernier argument de la commande simple précédente exécutée au premier plan, après développement. Il est défini également au chemin d'accès complet utilisé pour appeler chaque commande exécutée et se retrouve dans l'environnement exporté vers cette commande. Lors de la vérification de l'arrivée de courrier, le développement de $_ est le nom du fichier de courrier en cours de consultation.

BASH

Se développe en nom du fichier complet utilisé pour appeler cette instance 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, l'interpréteur active chaque option de la liste avant de lire les fichiers d’initialisation. Si cette variable est exportée, les interpréteurs enfant activeront chaque option de la liste. Cette variable est en lecture seule.

BASHPID

Se transforme en PID du processus 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é. Les affectations à BASHPID n'ont pas d'effet. Si BASHPID est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

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 ; cependant, la destruction d'éléments du tableau ne supprime pas actuellement les alias de la liste d'alias. Si BASH_ALIASES est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_ARGC

Une variable de type tableau contenant le nombre de paramètres de chaque trame de la pile d'exécution d'appels de l'interpréteur bash actuel. Le nombre de paramètres du sous-programme actuel (fonction de l'interpréteur ou du 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). La configuration de extdebug après que l'interpréteur a démarré l'exécution d'un script, ou le référencement de cette variable quand extdebug n'existe pas, peut provoquer une incohérence des valeurs. Les affectations à BASH_ARGC n'ont aucun effet et la variable ne peut pas être détruite.

BASH_ARGV

Une variable de type tableau contenant tous les paramètres de la pile d'exécution d'appels 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é, l'interpréteur place les paramètres fournis 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). La configuration de extdebug après que l'interpréteur a démarré l'exécution d'un script, ou le référencement de cette variable quand extdebug n'existe pas peut provoquer une incohérence des valeurs. Les affectations à BASH_ARGV n'ont aucun effet et la variable ne peut pas être détruite.

BASH_ARGV0

Quand elle est référencée, cette variable développe le nom de l'interpréteur ou du script de l'interpréteur (identique à $0 ; voir la description du paramètre spécial 0 ci-dessus). L'affectation d'une valeur à BASH_ARGV0 définit $0 à cette valeur. Si BASH_ARGV0 est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_CMDS

Une variable de type tableau associatif dont les éléments correspondent à la table de hachage interne de commandes comme celle gérée par la commande interne hash. Ajouter des éléments à ce tableau les fait apparaître dans la table de hachage ; cependant, la destruction d'éléments du tableau ne retire pas actuellement des noms de commandes de la table de hachage. Si BASH_CMDS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_COMMAND

Développe 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. Si BASH_COMMAND est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_EXECUTION_STRING

L'argument de 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 source 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. Les affectations à LINENO n'ont aucun effet et la variable ne peut pas être détruite.

BASH_LOADABLES_PATH

Liste des répertoires, séparés par des deux-points « : », que la commande enable consulte lorsqu'elle cherche les commandes internes chargeables dynamiquement.

BASH_MONOSECONDS

À chaque fois que cette variable est consultée, son développement est la valeur renvoyée par l'horloge monotone du système, s'il y en a une de disponible. S'il n'y en a pas, c'est équivalent à EPOCHSECONDS. Si BASH_MONOSECONDS est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_REMATCH

Une variable de type tableau dont les éléments sont affectés par 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.

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]}. Les affectations à BASH_SOURCE n'ont aucun effet et la variable ne peut pas être détruite.

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. Si BASH_COMMAND est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

BASH_TRAPSIG

Définie au numéro du signal correspondant à l'action de capture exécutée pendant son exécution. Consultez la description de trap dans COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous) pour des informations sur les numéros de signal et l'exécution de captures.

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 (par exemple 5.2.37(3)-release).

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 programmable (consultez Complètement programmable ci-dessous).

COMP_KEY

La touche (ou la touche finale d'une séquence de touches) utilisée pour appeler la fonction de complètement actuelle. Cette variable n'est disponible que dans les fonctions de l'interpréteur appelées par les outils de complètement programmable (consultez Complètement programmable ci-dessous).

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 programmable (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 programmable (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 des 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 complètement de menu. 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 programmable (consultez Complètement programmable ci-dessous).

COMP_WORDBREAKS

Le jeu de caractères que la bibliothèque readline considère comme des 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 programmable (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ées 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 modifie 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.

EPOCHREALTIME

À chaque fois que ce paramètre est consulté, il se développe en nombre de secondes écoulées depuis l'Epoch Unix (consultez time(3)) comme valeur en virgule flottante avec une granularité d'une microseconde. Les affectations à EPOCHREALTIME sont ignorées. Si EPOCHREALTIME est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

EPOCHSECONDS

À chaque fois que ce paramètre est consulté, il se développe en nombre de secondes écoulées depuis l'Epoch Unix (consultez time(3)). Les affectations à EPOCHSECONDS sont ignorées. Si EPOCHSECONDS 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'exécution d'appels. 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. 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'appels. 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. 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. Les affectations de HISTCMD n'ont aucun effet. 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 codes de retour des commandes exécutées dans le pipeline exécuté le plus récemment au premier plan qui peut éventuellement contenir une seule commande (consultez GRAMMAIRE DE L'INTERPRÉTEUR ci-dessus). bash définit PIPESTATUS après l'exécution de pipelines multi-éléments, de pipelines synchronisés et inversés, de commandes simples, de sous-interpréteurs avec l'opérateur (, les commandes composées [[ et ((, et après des conditions d'erreur qui entraînent l'arrêt de l'exécution de commandes par l'interpréteur.

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é, son développement est un entier aléatoire entre 0 et 32767. L'affectation d'une valeur à RANDOM initialise (ensemence) la suite de nombres aléatoires. Ensemencer le générateur de nombres aléatoires avec la même valeur constante produit la même suite de valeurs. Si RANDOM est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

READLINE_ARGUMENT

Tout argument numérique donné à une commande readline qui a été définie en utilisant “bind -x” (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous) quand il a été invoqué.

READLINE_LINE

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

READLINE_MARK

La position de la marque (point d'insertion enregistré) dans le tampon de ligne readline, pour utiliser avec “bind -x” (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous). Les caractères entre le point d'insertion et la marque sont souvent appelés la zone.

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

Définie à 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é, il se développe en nombre de secondes écoulées depuis le lancement de l'interpréteur. 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. Le nombre de secondes entre le moment du lancement de l'interpréteur et l'heure actuelle est toujours déterminé en interrogeant l'horloge système avec une résolution d'une seconde. 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, l'interpréteur active chaque option de la liste avant de lire les fichiers d’initialisation. Si cette variable est exportée, les interpréteurs enfant activeront chaque option de la liste. Cette variable est en lecture seule.

SHLVL

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

SRANDOM

Chaque fois qu'elle est consultée, cette variable génère un nombre pseudo-aléatoire de 32 bits. Le générateur de nombres aléatoires n'est pas linéaire sur les systèmes qui prennent en charge /dev/urandom ou arc4random(3), aussi chaque nombre renvoyé n'a aucune relation avec les nombres précédents. Le générateur de nombre aléatoire ne peut pas être ensemencé, aussi les affectations à cette variable n'ont aucun effet. Si SRANDOM est détruite, elle perd ses propriétés spéciales, même si elle est recréée par la suite.

UID

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

L'interpréteur utilise les variables suivantes. Dans certains cas, bash affecte des valeurs par défaut aux variables ; ces cas sont décrits ci-dessous.

BASH_COMPAT

Cette valeur est utilisée pour définir le niveau de compatibilité de l'interpréteur. Consultez MODE DE COMPATIBILITÉ DE L'INTERPRÉTEUR ci-dessous 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. Un sous-ensemble des valeurs possibles correspond aux niveaux de compatibilité décrits ci-dessous dans MODE DE COMPATIBILITÉ DE L'INTERPRÉTEUR. Par exemple, 4.2 et 42 sont des valeurs possibles qui correspondent à l'option compat42 de shopt et définissent le niveau de compatibilité à 42. La version actuelle est aussi une valeur possible.

BASH_ENV

Si ce paramètre existe lorsque bash exécute un script, sa valeur développée est considérée comme un nom de fichier contenant les commandes d'initialisation de l'interpréteur avant qu'il lise et exécute les commandes du script. 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 nom de fichier résultant.

BASH_XTRACEFD

Si configurée à une valeur entière correspondant à un descripteur de fichier correct, bash écrit la trace de sortie si “set -x” est activé vers ce descripteur de fichier, à la place de la sortie d'erreur standard. 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 fait que la trace de sortie est envoyée 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 où l'interpréteur cherche les répertoires spécifiés comme arguments de la commande cd. Un exemple de valeur est “.:~:/usr”.

CHILD_MAX

Définir le nombre de valeurs d’état de sortie des enfants 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 programmable (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 de ligne.

ENV

Développé et exécuté de façon similaire à BASH_ENV (consultez APPEL ci-dessus) quand l'interpréteur interactif est invoqué en mode POSIX.

EXECIGNORE

Une liste, séparée par des deux-points « : », de motifs de l'interpréteur (voir Motifs génériques) définissant l'ensemble de noms de fichier à ignorer par la commande de recherche utilisant PATH. Les fichiers dont les noms de chemin complets correspondent à un de ces motifs ne sont pas considérés comme des fichiers exécutables en vue du complètement et de l'exécution de commande au moyen d'une recherche dans PATH. Cela n'affecte pas le comportement des commandes [, test et [[. Les noms de chemin complets dans la table de hachage des commandes ne sont pas sujets à EXECIGNORE. Utiliser cette variable pour ignorer des fichiers de bibliothèque partagée dont le bit exécutable est présent, mais qui ne sont pas des fichiers exécutables. La correspondance de motif respecte la configuration de l'option d'interpréteur extglob.

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 fichier (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 correspondants 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 forcent la commande actuelle à abandonner.

GLOBIGNORE

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

GLOBSORT

Contrôle la manière dont les résultats de développement des chemins sont triés. La valeur de cette variable spécifie le critère et l'ordre de tri des résultats de développement des chemins. Si cette variable est détruite ou définie à une chaîne NULL, le développement des chemins utilise le comportement historique en triant par nom, en ordre lexicographique ascendant tel que déterminé par la variable d'interpréteur LC_COLLATE.

Si elle existe, la valeur valable commence par un + facultatif qui est ignoré, ou un - qui inverse l'ordre de tri d'ascendant à descendant, suivi d'un indicateur de tri. Les indicateurs de tri valables sont name, numeric, size, mtime, atime, ctime et blocks qui trient les fichiers respectivement par nom, noms par ordre numérique plutôt que par ordre lexicographique, par taille de fichier, par heure de modification, par heure d'accès, par heure de modification d'inœud ou par nombre de blocs. Si deux clés de tri autres que le nom sont jugées égales (par exemple, si deux fichiers sont de même taille), le tri utilise le nom comme clé de tri secondaire.

Par exemple, une valeur de -mtime trie les résultats en ordre descendant par heure de modification (les plus récents d'abord).

L'indicateur numeric traite les noms composés uniquement de chiffres comme des nombres et les trie en utilisant leur valeur numérique (ainsi “2” est trié avant “10”, par exemple). Lors de l'utilisation de numeric, les noms contenant des caractères non numériques sont triés après tous les noms entièrement numériques et sont triés par nom suivant le comportement traditionnel.

Un indicateur de tri nosort désactive totalement le tri ; bash renvoie les résultats dans l'ordre où ils sont lus à partir du système de fichiers, ignorant un - de tête.

Si l'indicateur de tri est absent, la valeur par défaut est name, ainsi une valeur de + est équivalente à la chaîne NULL et une valeur de - trie par nom en ordre descendant. Une valeur nom valable restaure le comportement de tri historique.

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 valable, toutes les lignes lues par l'analyseur de l'interpréteur seront sauvegardées dans la file d'historique, selon la valeur de HISTIGNORE. Si la première ligne d'une commande composée multiligne a été sauvegardée, la seconde ligne et les suivantes ne sont pas testées et sont ajoutées dans l'historique indépendamment de la valeur de HISTCONTROL. Si la première n'a pas été sauvegardée, la seconde ligne de la commande et les suivantes ne le sont pas non plus.

HISTFILE

Le nom du fichier dans lequel l'historique des commandes est sauvegardé (consultez HISTORIQUE ci-dessous). Par défaut, bash assigne la valeur de ~/.bash_history. Si HISTFILE n'est pas défini ou NULL, l'interpréteur ne sauvegarde pas l'historique des commandes lorsqu'il 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 le nombre d'entrées d'historique qui ne dépasse pas ce nombre de lignes en enlevant les entrées les plus anciennes. Si le fichier d'historique contient des entrées multilignes, le fichier d'historique peut contenir plus de lignes que ce maximum pour éviter de conserver des entrées d'historique partielles. Ce fichier est aussi tronqué à cette taille après son écriture quand un interpréteur se termine ou par la commande interne history. 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 doivent être sauvegardées sur la liste d'historique. Si une ligne de commande correspond à un des motifs dans la valeur de HISTIGNORE, elle n'est pas sauvegardée sur la liste d'historique. Chaque motif est accroché au début de la ligne et doit correspondre à la ligne complète (bash n'ajoute pas implicitement un “*”). Chaque motif est comparé à chaque ligne après application des vérifications spécifiées par HISTCONTROL. En plus des caractères correspondant aux motifs génériques usuels de l'interpréteur, “&” correspond à la ligne précédente de l'historique. Une contre-oblique protège le “&”; la contre-oblique est supprimée avant de tenter une comparaison. Si la première d'une commande composée multiligne a été sauvegardée, la seconde ligne et les suivantes ne sont pas testées et sont ajoutées dans l'historique indépendamment de la valeur de HISTIGNORE. Si la première n'a pas été sauvegardée, la seconde ligne de la commande et les suivantes ne le sont pas non plus. La correspondance de motif respecte la configuration de l'option d'interpréteur extglob.

HISTIGNORE inclut certaines des fonctions de HISTCONTROL. Un motif de “&” est identique à “ignoredups”, et un motif de “[ ]*” est identique à “ignorespace”. La combinaison de ces deux motifs séparés par un deux-points fournit la fonctionnalité de “ignoreboth”.

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 file d’historique. Les valeurs négatives permettent de sauvegarder toutes les commandes dans la file 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, l'interpréteur écrit les horodatages dans le fichier d'historique afin qu'ils soient conservés au fur et à mesure des sessions de l'interpréteur. Cette écriture utilise le caractère de commentaire d'historique pour distinguer l'horodatage des autres lignes de l'historique.

HOME

Le répertoire personnel (home) 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 doit être lu lorsque l'interpréteur a besoin de compléter un nom de machine. La liste des complètements possibles de noms de machine peut être modifié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 à la liste existante le contenu du nouveau fichier. 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 nom de machine possibles. Lorsque HOSTFILE est détruite, bash efface la liste des noms de machine.

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. Le découpage en mots est décrit dans DÉVELOPPEMENTS ci-dessous. La valeur par défaut est “<space><tab><newline>”.

IGNOREEOF

Commande le comportement d'un interpréteur interactif à la 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 saisis comme premiers caractères sur une ligne de saisie avant que bash ne termine. Si la variable est définie 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'est pas définie, EOF signifie la fin de la saisie pour l'interpréteur.

INPUTRC

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

INSIDE_EMACS

Si cette variable apparaît dans l'environnement quand le script démarre, bash considère qu'il s'exécute dans un tampon d'interpréteur d'Emacs et peut désactiver l'édition de ligne selon la valeur de TERM.

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 outrepasse 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 motif.

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 la correspondance de motif.

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.

LC_TIME

Cette variable détermine le paramètre linguistique régional utilisé pour le formatage des données et de l'heure.

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 la valeur 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 courriels dans le fichier indiqué ou le répertoire au format Maildir.

MAILCHECK

Indique la périodicité (en seconde) à laquelle bash vérifie si un nouveau courriel est arrivé. La valeur par défaut est 60 secondes. Lorsque le délai est écoulé, l'interpréteur vérifie la présence d'un courriel é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 fichier séparés par des deux-points « : », dans laquelle on vérifiera l'arrivée de courriels. Le message à afficher lors de la réception d'un courriel dans un fichier particulier peut être spécifié en séparant le nom du fichier du message par un “?”. Lorsqu'il est utilisé dans le texte du message, le développement de $_ est le nom du fichier de courrier actuel. Par exemple :

MAILPATH='/var/mail/bfox?"Vous avez du courrier":~/shell-mail?"$_ a du courrier !"'

OPTERR

Si configurée à la valeur 1, bash affiche les messages d'erreur généré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 à l'exécution 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 laquelle 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 nom de répertoire NULL peut apparaître sous la forme de 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:.if  0<78n .br
/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. Quand l'interpréteur passe en mode POSIX, il configure cette variable si elle ne l'a pas déjà été.

PROMPT_COMMAND

Si cette variable existe et est un tableau, la valeur de chaque élément existant est exécutée comme commande préalablement à l'affichage de chaque invite de base. Si elle existe mais n'est pas une variable de type tableau, sa valeur est utilisée comme commande à exécuter à la place.

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 des points de suspension.

PS0

La valeur de ce paramètre est développée (consultez INVITES ci-dessous) puis affichée par les interpréteurs interactifs après la lecture d'une commande et avant son exécution.

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 avant chaque commande affichée par bash 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

Cette variable développe le chemin d'accès complet à l'interpréteur de commandes. Si elle est 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 temps doivent être affichées pour les pipelines préfixés par le 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 indiquent 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 à l'affichage de nombres entiers. time affiche au plus six chiffres après la virgule ; toute valeur de p supérieure à 6 sera modifiée en 6. Si p n'est pas précisé, time affiche trois chiffres après la virgule.

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, bash n'affiche aucune information de chronométrage. Un caractère final de changement de ligne est ajouté quand la chaîne de format est affichée.

TMOUT

Si définie à une valeur strictement positive, la commande interne read utilise la valeur comme délai par défaut. 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 ou contiennent le mot, 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 (par exemple, préfixe), le mot fourni doit être le préfixe du nom d'une tâche suspendue ; cela fournit une fonctionnalité analogue à l'identificateur de tâche %chaîne.

histchars

Les deux ou trois caractères commandant le développement de l'historique, la substitution rapide 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 le caractère de substitution rapide, normalement “^”. Lorsqu'il apparaît comme premier caractère de la ligne, la substitution d'historique répète la commande précédente, remplaçant une chaîne par une autre. Le troisième caractère facultatif est le caractère commentaire d'historique, normalement “#”, qui indique que le reste de la ligne est un commentaire quand il apparaît comme premier caractère d'un mot. Le caractère de commentaire d'historique désactive la substitution d'historique pour les mots restant sur la ligne. Il ne fait pas nécessairement que l'analyseur de l'interpréteur traite 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 déclare 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 référencés avec des expressions arithmétiques qui doivent être développées en un entier (consultez ÉVALUATION ARITHMÉTIQUE ci-dessous) et commençant à zéro ; les tableaux associatifs sont référencés avec des chaînes arbitraires. Sauf mention contraire, les indices de tableaux indicés ne doivent pas être des entiers négatifs.

L'interpréteur effectue le développement des paramètres, des variables, le développement arithmétique, la substitution de commande, ainsi que la suppression des protections sur les indices de tableau indicés. Comme cela peut potentiellement aboutir à des chaînes vides, l'indexation par indice les traite comme des expressions qui sont évaluées à 0.

L'interpréteur effectue le développement des tildes, des paramètres et des variables, le développement arithmétique, la substitution de commande ainsi que la suppression des protections sur les indices de tableau associatif. Des chaînes vides ne peuvent pas être utilisées comme clés de tableau associatif.

bash crée automatiquement un tableau indicé si une variable est affectée à l'aide de la syntaxe

Les tableaux associatifs sont créés en utilisant

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

Les tableaux sont affectés en utilisant l'affectation composée de la forme nom=(valeur_1 ... valeurn), où chaque valeur peut être de la forme [indice]=chaîne. Les affectations de tableau indicé ne nécessitent rien d’autre que chaîne. Chaque valeur de la liste est développée en utilisant tous les développements de l'interpréteur décrits ci-dessous dans DÉVELOPPEMENTS, mais les valeurs qui sont des affectations de variables valables, y compris les crochets et l'indice, ne sont pas soumises au développement des accolades ni au découpage en mots, comme c'est le cas pour l'affectation de variables individuelles.

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 à un tableau associatif, les mots d'une affectation composée peuvent être soit des affectations pour lesquelles un indice est requis, soit une liste de mots qui est interprétée comme une séquence alternant clés et valeurs : nom=( clé1 valeur1 clé2 valeur2 ...). Elles sont traitées de la même manière que nom=( [clé1]=valeur1 [clé2]=valeur2 ...). Le premier mot de la liste détermine comment les autres mots sont interprétés ; toutes les affectations d'une liste doivent être du même type. Lors de l'utilisation de paires clé/valeur, les clés ne peuvent pas être absentes ou vides ; une valeur finale absente est traitée comme une chaîne vide.

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 à 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.

L'opérateur “+=” concatène à une variable tableau lors d'une affectation en utilisant la syntaxe d'affectation composée ; consultez PARAMÈTRES ci-dessous.

Un élément de tableau est référencé 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 développement de mot est tous les éléments de nom, à moins que cela soit noté dans la description d'une commande interne ou d'un développement de mot. Ces deux indices ne diffèrent que lorsque le mot apparaît entre guillemets doubles. Si le mot est entre guillemets doubles, le développement de ${nom[*]} est 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[@]} 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 développement du mot original et le développement du dernier paramètre est accolé à la dernière partie du développement du mot original. Le comportement est analogue à celui des paramètres spéciaux * et @ (consultez Paramètres spéciaux ci-dessus).

Le développement de ${#nom[indice]} correspond à la longueur de ${nom[indice]}. Si l'indice est * ou @, le développement est le nombre d'éléments dans le tableau.

Si l'indice utilisé pour référencer un élément d'un tableau indicé est évalué à un nombre inférieur à zéro, il est interprété comme un indice relatif à 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.

Le référencement d'une variable tableau sans indice est équivalent au référencement d'un tableau avec un indice de 0. Toute référence à une variable utilisant un indice valable est valable et bash crée un tableau si nécessaire.

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 clés (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, pour à la fois les tableaux indicés et les tableaux associatifs. Les indices négatifs des tableaux indicés sont traités comme décrit précédemment. Supprimer le dernier élément d'une variable tableau ne détruit pas la variable. unset nom, où nom est un tableau, supprime le tableau entier. unset nom[indice] se comporte différemment selon que nom est un tableau indicé ou associatif où indice est un * ou un @. Si nom est un tableau associatif, la commande détruit l'élément avec un indice * ou @. Si nom est un tableau indicé, unset supprime tous les éléments mais ne supprime pas le tableau lui-même.

Lors de l'utilisation d'un nom de variable avec un indice comme argument d'une commande comme avec unset, sans utiliser la syntaxe des développements de mots décrite précédemment, (par exemple, unset a[4]), l'argument est sujet au développement des chemins. L'argument doit être protégé si le développement des chemins n'est pas souhaité, (par exemple, unset 'a[4]').

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. Les autres commandes internes acceptent également les arguments de nom de tableau (par exemple, mapfile) ; consultez la description de chaque commande interne ci-dessous pour des détails. L'interpréteur fournit plusieurs variables de tableau intégrées.

Développement des accolades¶

Le développement des accolades est un mécanisme permettant de produire des chaînes arbitraires partageant un préfixe et suffixe communs, l'un ou l'autre pouvant être vide. Il est similaire au développement des chemins, mais les noms de fichier produits n'existent pas nécessairement. Les motifs qui seront développés sont formés d'un préambule facultatif, suivi soit d'une série de chaînes séparées par des virgules, soit de l'expression d'une série entre accolades, et suivi d'un post-scriptum facultatif. Le préambule est inséré devant chacune des chaînes situées 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 ; le développement d'accolades conserve l'ordre de gauche à droite. Par exemple, a{d,c,b}e se développe en “ade ace abe”.

Une expression de séquence est de la forme x..y[..incr], où x et y sont soit des entiers, soit des lettres 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. Si x ou y commencent par un zéro, chaque terme généré contiendra le même nombre de chiffres, en ajoutant des zéros au besoin. S'il s'agit de lettres, l'expression se développe à 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 de C. Remarquez que x et y doivent être du même type (entier ou lettre). 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 selon 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 contexte du développement ni 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 valable. Tout développement d'accolades incorrectement formé est laissé inchangé.

Un “{” ou un Q, 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, et empêche le développement d'accolades jusqu'au dernier “}”.

Cette construction est typiquement utilisée comme raccourci lorsque le préfixe commun aux chaînes à générer est plus long que dans les exemples précédents :

mkdir /usr/local/src/bash/{old,new,dist,bugs}

chown root /usr/{ucb/{ex,edit},lib/{ex?.?*,how_ex}}

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, bash le transforme en “file1 file2” après le développement d'accolades. Lancez bash avec l'option +B ou désactivez le développement des accolades avec l'option +B de la commande set si une compatibilité stricte avec sh est nécessaire (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 tilde correspond au répertoire personnel de l'utilisateur exécutant l'interpréteur à la place. Sinon le préfixe tilde est remplacé par le répertoire personnel 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 tel 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 non précédé de “+” ou “-”, le développement du tilde présume que c'est “+”.

Les résultats du développement sont traités comme s'ils étaient protégés, aussi les remplacements ne sont pas sujets au découpage en mots et au développement des chemins.

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

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

bash effectue aussi le développement des tildes sur les mots satisfaisant les conditions d'affectations de variable (comme décrit précédemment dans PARAMÈTRES) quand elles apparaissent comme arguments de commandes simples. bash ne le fait pas en mode POSIX sauf pour les commandes de déclaration listées ci-dessus.

Développement des paramètres¶

L'opérateur “$” permet d'introduire le développement des paramètres, la substitution de commande ou le développement arithmétique. Les noms du paramètre ou du symbole à développer peuvent être encadrés par des accolades facultatives, mais qui permettent d'éviter le développement de la variable à partir de caractères les suivant immédiatement et qui pourraient être considérés comme appartenant à leur 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.

La forme élémentaire de développement des paramètres est

${paramètre}

qui remplace 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 (!), et si le paramètre n'est pas un nameref, il introduit un niveau d'indirection de variable. bash utilise la valeur formée par le développement du reste du paramètre en tant que nouveau paramètre. Ce nouveau paramètre est alors développé et la valeur utilisée pour le reste du développement plutôt que le développement du paramètre original. On appelle ce mécanisme le développement indirect. La valeur est sujette au développement de tildes et de paramètres, à la substitution de commande ou au développement arithmétique. Si le paramètre est un nameref, le développement porte sur le nom du paramètre référencé par le paramètre plutôt que sur le développement indirect complet pour des raisons de compatibilité. Les exceptions à cela 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'indirection.

Dans chacun des cas ci-dessous, le mot est soumis au développement de 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 est affecté à paramètre et il est la valeur finale. 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, l'interpréteur affiche le développement du mot (ou un message approprié si aucun mot n'est fourni) sur la sortie d'erreur standard et, s'il n'est pas interactif, l'interpréteur termine avec un code différent de zéro. Un interpréteur interactif ne termine pas, mais n'exécute pas la commande associée au développement. 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é. La valeur du paramètre n'est pas utilisée.

${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 @ ou *, un tableau indicé par @ ou *, ou un nom de tableau associatif, le résultat diffère comme décrit ci-dessous. Si :longueur est omis (la première forme ci-dessus), le développement est la sous-chaîne commençant au caractère indiqué par début et s'étendant jusqu'à la fin de la valeur. Si début est omis, il est traité comme un zéro. Si longueur est omise, mais si les deux-points après début sont présents, il est traité comme un zéro. 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 du 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 @ ou *, 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 (ou 0 s'il n'y a pas de paramètre positionnel). C’est une erreur de développement si longueur est évaluée à un 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 à un 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 clés du tableau. Si nom est une variable de type tableau, elle se développe en liste des indices (clés) 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 clé se développe en un mot séparé.

${#paramètre}

Longueur du paramètre. Remplace la longueur, en caractères, de la valeur développée 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 et mis en correspondance avec la valeur développée du paramètre avec les règles décrites dans Motifs génériques ci-dessous. Si le motif correspond au début de la valeur du paramètre, alors le résultat du développement prend la valeur développée du paramètre après suppression du motif correspondant le plus court (cas “#” ) ou du plus long (cas “##” ). 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 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 et mis en correspondance avec la valeur développée du paramètre avec les règles décrites dans Motifs génériques ci-dessous. 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 motif correspondant le plus court (cas “%” ) ou du plus long (cas “%%” ). 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 est appliquée à chaque élément du tableau tour à tour et le développement est la liste résultante.

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

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

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

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

Substitution de motif. Le motif est développé pour produire un motif et comparé à la valeur développée du paramètre comme décrit dans Motifs génériques ci-dessous. La plus longue portion correspondant au motif est remplacée par la chaîne. La chaîne est sujette au développement du tilde, des paramètres et des variables, au développement arithmétique, à la substitution de commande et de processus, et à la suppression des protections.

Dans la première forme ci-dessus, seule la première correspondance est remplacée. S'il y a deux barres obliques séparant le paramètre et le motif, (la seconde forme ci-dessus) toutes les correspondances au motif sont remplacées par la chaîne. Si le motif est précédé de # (la troisième forme ci-dessus), il doit correspondre au début de la valeur développée du paramètre. Si le motif est précédé de % (la quatrième forme ci-dessus), il doit correspondre à la fin de la valeur développée du paramètre.

Si le développement de la chaîne est NULL, les portions correspondant au motif sont supprimées et le / suivant le motif peut être omis.

Si l'option d'interpréteur patsub_replacement est activée en utilisant shopt, toutes les instances non protégées de & dans la chaîne sont remplacées par la partie correspondante du motif.

La protection d'une partie de la chaîne empêche les remplacements dans le développement de la partie protégée, y compris le remplacement des chaînes stockées dans les variables de l'interpréteur. La contre-oblique protège & dans la chaîne ; la contre-oblique est supprimée afin de permettre un & littéral dans la chaîne de remplacement. La contre-oblique peut aussi être utilisée pour protéger une contre-oblique ; \\ résulte en une contre-oblique littérale dans le remplacement. Les utilisateurs doivent faire attention si la chaîne est protégée entre des guillemets doubles pour éviter des interactions non souhaitées entre la contre-oblique et les guillemets doubles, dans la mesure où la contre-oblique a une signification particulière avec des guillemets doubles. La substitution de motif réalise la vérification de la présence de & non protégée après le développement de chaîne ; les développeurs de programmes d’interpréteur doivent protéger toutes les occurrences de & qu'ils souhaitent être traitées littéralement dans le remplacement et s'assurer que toutes les instances de & qu'ils souhaitent voir remplacées ne soient pas protégées.

Comme les opérateurs de suppression de motif, les guillemets doubles entourant la chaîne de remplacement protègent les caractères développés, tandis que les guillemets doubles encadrant toute la substitution de paramètre ne le font pas, dans la mesure où le développement est réalisé dans un contexte qui ne prend pas en compte les guillemets doubles encadrants.

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.

Si le paramètre est @ ou *, l'opération de substitution 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 substitution est appliquée à 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. D'abord, le motif est développé pour fournir un motif, comme décrit dans Motifs génériques ci-dessous. bash teste chaque caractère de la valeur développée du paramètre par rapport au motif comme décrit ci-dessous. Si un caractère correspond au motif, sa casse est convertie. Le motif ne doit pas essayer de correspondre à plus d’un caractère.

L'utilisation de “^” convertit les lettres minuscules correspondant au motif en capitales ; “,” convertit les lettres capitales correspondant à ce motif en minuscules. Les variantes ^ et , examinent le premier caractère de la valeur développée et convertissent sa casse s'il correspond au motif ; les variantes ^^ et ,, examinent tous les caractères de la valeur développée et convertissent tous ceux qui correspondent au motif. Si motif est omis, il est traité comme un ?, ce qui correspond à n'importe quel caractère.

Si le paramètre est @ ou *, l'opération de modification de casse 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 modification de casse est appliquée à chaque élément du tableau tour à tour et le développement est la liste résultante.

${paramètre@opérateur}

Transformation de paramètre. Le développement est soit une transformation de la valeur du paramètre ou des informations sur paramètre lui-même, selon la valeur de opérateur. Chaque opérateur est une lettre unique :

Substitution de commande¶

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

bash effectue le développement en exécutant la commande dans un environnement de sous-interpréteur et en remplaçant la substitution de commande par sa sortie standard dont les éventuels sauts de ligne 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).

Avec l'ancienne forme de substitution avec les accents graves « ` », 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.

Il existe une autre forme de substitution de commande :

qui exécute la commande dans l'environnement d'exécution actuel et capture sa sortie, les caractères finaux de changement de ligne étant aussi supprimés.

Le caractère c suivant l'accolade ouvrante doit être une espace, une tabulation, un changement de ligne ou un |, et l'accolade fermante doit être à une position où un mot réservé peut apparaître (c'est-à-dire précédée d'une terminaison de commande telle un point-virgule). bash permet que l'accolade fermante soit jointe aux caractères restants du mot sans être suivie d'un métacaractère de l'interpréteur comme l'exigerait habituellement un mot réservé.

Tout effet secondaire d'une commande prend effet immédiatement dans l'environnement d'exécution actuel et persiste dans cet environnement après la fin de la commande (par exemple, la commande interne exit quitte l'interpréteur).

Ce type de substitution de commande ressemble de façon superficielle à l'exécution d'une fonction d'interpréteur sans nom : des variables locales sont créées comme lors de l'exécution d'une fonction d'interpréteur et la commande interne return force la commande à se terminer ; néanmoins, le reste de l'environnement d'exécution, y compris les paramètres positionnels, est partagé avec l'appelant.

Si le premier caractère suivant l'accolade ouvrante est un |, la construction se développe à la valeur de la variable d'interpréteur REPLY après l'exécution de la commande, sans supprimer les éventuels sauts de ligne finaux, et la sortie standard de la commande reste la même que dans l'interpréteur appelant. bash crée REPLY comme une variable locale non définie initialement quand la commande s'exécute et restaure REPLY à la valeur qu'elle avait avant la substitution de commande après que la commande a terminé, comme pour toute variable locale.

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, bash n'effectue pas le découpage en mots et le développement des chemins sur les résultats.

Développement arithmétique¶

Le développement arithmétique évalue une expression arithmétique et le résultat lui est substitué. 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 des caractères guillemet double qui ne sont pas échappés dans l'expression ne sont pas traités spécifiquement et sont supprimés. Tous les lexèmes dans l'expression sont sujets 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. Dans la mesure où la manière dont bash gère les guillemets doubles peut aboutir potentiellement à des chaînes vides, le développement arithmétique les traite comme des expressions qui s'évaluent à 0. Les développements arithmétiques peuvent être imbriqués.

L'évaluation est effectuée conformément aux règles décrites ci-dessous dans ÉVALUATION ARITHMÉTIQUE. Si l'expression est non valable, bash affiche un message sur la sortie d'erreur standard indiquant l'échec, n'effectue pas la substitution et n'exécute pas la commande associée au développement.

Substitution de processus¶

La substitution de processus permet à une entrée ou une sortie d'un processus d’être référencée en utilisant un nom de fichier. Elle prend la forme <(liste) ou >(liste). La liste de processus est exécutée de façon asynchrone et son entrée ou sortie apparaît comme un nom de fichier. Le nom de ce fichier est passé en argument à la commande actuelle comme résultat de ce développement.

Si la forme >(list) est utilisée, l'écriture dans le fichier fournit une entrée pour liste. Si la forme <(list) est utilisée, la lecture du fichier permet d'obtenir le résultat de liste. Il ne doit y avoir aucune espace entre le < ou le > et la parenthèse ouvrante, sinon la construction serait interprétée comme une redirection.

La substitution de processus est prise en charge sur les systèmes acceptant le mécanisme des tubes nommés (FIFO) ou la méthode /dev/fd de nommage de fichiers ouverts.

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. Les mots qui ne sont pas développés ne sont pas découpés.

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.

Un caractère blanc de IFS est une espace comme définie ci-dessus (voir Définitions qui apparaît dans la valeur de IFS. Une espace, une tabulation ou un changement de ligne sont toujours considérés comme une espace IFS même s'ils n'apparaissent pas dans la catégorie espace du paramètre linguistique régional.

Si IFS n'existe pas, le découpage de champ agit comme si sa valeur était <espace><tab><changement_de_ligne> et traite ces caractères comme un caractère blanc de IFS. Si la valeur de IFS est NULL, aucun découpage n'est effectué, mais les arguments NULL implicites (voir plus bas) sont toujours supprimés.

Le découpage en mots commence par la suppression des séquences de caractères blancs de IFS du début et de la fin des résultats du développement précédent, puis découpe les mots restants.

Si la valeur de IFS consiste uniquement en blanc de IFS, toute séquence de caractères blancs de IFS délimite un champ ; ainsi un champ consiste en caractères qui ne sont pas des blancs de IFS non protégés, et les champs NULL ne résultent que de la protection.

Si IFS contient un caractère qui n'est pas une espace, tout caractère de la valeur de IFS n'est pas un blanc de IFS et tous les caractères blancs de IFS adjacents délimitent un champ. Cela signifie que des délimiteurs qui ne sont pas des blancs de IFS adjacents produisent un champ NULL. Une séquence de caractères blancs de IFS délimite également un champ.

Les arguments NULL explicites ("" ou '') sont conservés et passés à des commandes comme chaînes vides. 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. Le développement d'un paramètre sans valeur entre guillemets doubles produit un champ NULL, qui est conservé et passé à une commande comme une chaîne vide.

Quand un argument NULL protégé apparaît comme appartenant à un mot dont le développement n'est pas NULL, le découpage en mots supprime la portion d'argument NULL, laissant le développement non NULL. C'est-à-dire que le mot “-d''” devient “-d” après le découpage en mots et le retrait de l'argument NULL.

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 et n'est pas protégé, le mot est considéré comme un motif et remplacé par une liste triée de noms de fichier correspondant à ce motif (consultez Motifs génériques ci-dessous) en fonction de la valeur de la variable de l'interpréteur GLOBSORT.

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, bash affiche un message d'erreur et n'exécute pas la commande. 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 ne soit activée. Pour être mis en correspondance avec les noms de fichier . et .., le motif doit débuter par un “.” (par exemple : “.?”), même si l'option dotglob est activée. Si l'option d'interpréteur globskipdots est activée, les noms de fichier . et .. ne sont jamais mis en correspondance, même si le motif débute par un “.”. Quand il ne s'agit pas de correspondance avec des chemins, le caractère “.” n'est pas traité spécifiquement.

Lors de la correspondance avec un chemin, le caractère barre oblique doit toujours être mis en correspondance explicitement par une barre oblique dans le motif, mais dans les autres contextes de correspondance, il peut être mis en correspondance par un caractère de motif spécial comme décrit ci-dessous dans Motifs génériques.

Voir la description de la commande shopt dans COMMANDES INTERNES DE L'INTERPRÉTEUR pour une description des options d'interpréteur nocaseglob, nullglob, globskipdots, failglob et dotglob.

La variable de l'interpréteur GLOBIGNORE peut servir à restreindre l'ensemble des noms de fichier correspondant à un motif. Si GLOBIGNORE existe, chaque nom de fichier qui correspond aussi à un motif de GLOBIGNORE est supprimé de la liste des correspondances. Si l'option nocaseglob existe, la mise en correspondance avec les motifs dans GLOBIGNORE est réalisée sans tenir compte de la casse. Les noms de fichier . 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 fichier 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. La correspondance de motif respecte la configuration de l'option d'interpréteur extglob.

La valeur de la variable d'interpréteur GLOBSORT contrôle la manière dont les résultats de développement des chemins sont triés, comme décrit ci-dessus dans Variables de l'interpréteur.

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 NULL 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 de motifs ont les significations suivantes :

Si l'option extglob d'interpréteur est activée en utilisant la commande interne shopt l'interpréteur reconnaît plusieurs opérateurs de correspondance étendue. Dans la description suivante, une liste-motifs 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 :

L'option extglob d'interpréteur modifie le comportement de l'analyseur dans la mesure où les parenthèses sont normalement traitées comme des opérateurs avec une signification syntaxique. Pour être sûr que les motifs développés mis en correspondance sont analysés correctement, il faut s'assurer que extglob est activé avant d'analyser les constructions contenant les motifs, y compris les fonctions de l'interpréteur et les substitutions de commande.

Lors de la correspondance avec des noms de fichier, l'option de l'interpréteur dotglob détermine l'ensemble de noms de fichier à tester : quand dotglob est activé, l'ensemble de noms de fichier inclut tous les fichiers commençant par “.”, mais . et .. doivent être mis en correspondance avec un motif ou un sous-motif qui commence par un point ; quand dotglob est désactivé, l'ensemble ne comprend pas tous les fichiers commençant par “.” à moins que le motif ou le sous-motif débute par un “.”. Si l'option d'interpréteur globskipdots est activée, les noms de fichier . et .. n'apparaissent jamais dans l'ensemble. Comme précédemment, “.” tout seul a une signification particulière lors de la correspondance avec des noms de fichier.

La mise en correspondance de motifs étendus complexes avec de longues chaînes est lente surtout quand les motifs contiennent des alternances et les chaînes contiennent plusieurs correspondances. L'utilisation de correspondances séparées avec des chaînes plus courtes ou en utilisant des tableaux de chaînes à la place d'une longue chaîne unique peut être plus rapide.

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 ouvre en lecture avec le descripteur de fichier numéro n le 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 ouvre en écriture le 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 échoue 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 si l'opérateur de redirection > avec l'option noclobber de la commande interne set non activée, bash tente la redirection même si le fichier dont le nom résulte du développement du mot existe.

Concaténation d'une sortie redirigée¶

La redirection de la sortie de cette façon ouvre le fichier dont le nom résulte du développement du mot pour une concaténation du descripteur de fichier n ou de 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 la concaténation de sorties est :

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

Cette construction redirige à la fois la sortie standard (descripteur 0) et la sortie d'erreur standard (descripteur 2) dans le fichier dont le nom est le résultat du développement du mot.

Il y a deux formes pour rediriger la sortie standard et la 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é.

Concanétation de la sortie standard et de la sortie d'erreur standard¶

Cette construction ajoute à la fois la sortie standard (descripteur 1) et la sortie d'erreur standard (descripteur 2) au fichier dont le nom est le résultat du développement du mot.

La forme pour l'ajout de la sortie standard et de la sortie d'erreur standard est :

C'est sémantiquement équivalent à

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

Document en ligne (herdoc)¶

Ce type de redirection commande à l'interpréteur de lire son entrée du code source actuel jusqu'à ce qu'il voie une ligne contenant seulement le délimiteur prévu (sans blancs finaux). Toutes les lignes lues jusqu'à ce point deviennent alors l'entrée standard (ou le descripteur de fichier n, si n est spécifié) pour une commande.

Le format des heredoc est le suivant :

[n]<<[-]mot


        heredoc
délimiteur

L'interpréteur n'effectue pas le développement de paramètre et de variable, la substitution de commande, le développement arithmétique ou le développement des chemins sur le mot.

Si une partie du mot est protégée, le délimiteur est le résultat de la suppression des protections sur mot et les lignes du heredoc ne sont pas développées. Si mot n'est pas protégé, le délimiteur est le mot lui-même et le heredoc est traité de la même façon qu'une chaîne entre guillemets doubles : toutes les lignes du heredoc 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 traitée littéralement et \ doit être utilisée pour protéger les caractères \, $ et `. Néanmoins, les guillemets doubles n'ont pas de signification particulière.

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

Si le délimiteur n'est pas protégé, la suite de caractères \<changement_de_ligne> est traitée comme une continuation de ligne : les deux lignes sont jointes et la paire contre-oblique/changement de ligne est supprimée. Cela se produit lors de la lecture du document en ligne, avant la vérification du délimiteur de fin, de sorte que les lignes jointes peuvent former le délimiteur de fin.

Chaînes en ligne (here-string)¶

Une variante aux heredoc dont le format est :

[n]<<<mot

Le mot est sujet au développement 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 ne sont réalisés. Le résultat est fourni comme une seule chaîne, avec l'ajout d'un caractère de changement de ligne, à la commande sur son entrée standard (ou sur le descripteur de fichier n, si n est spécifié).

Dédoublement de descripteurs de fichier¶

L'opérateur de redirection

permet de dupliquer les descripteurs de fichier en entrée. Si le mot se transforme en un ou plusieurs chiffres, le descripteur de fichier n devient une copie de ce descripteur. C'est une erreur de redirection si les chiffres du mot ne correspondent pas à un descripteur ouvert en lecture. 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 spécifié, la sortie standard (descripteur 1) est utilisée. Il s'agit d'une erreur de redirection si les chiffres du mot ne spécifient pas un descripteur de fichier ouvert en écriture. Si mot est évalué à -, 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 -, cela redirige les sorties standard et d'erreur standard comme décrit précédemment.

Déplacement de descripteurs de fichier¶

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

ouvre le 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¶

Ce paragraphe utilise les concepts d'édition de style Emacs et utilise sa notation pour 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. La touche Méta est souvent étiquetée “Alt” ou “Option”.

Sur les claviers sans touches Méta, M-x signifie ESC x, c'est-à-dire presser et relâcher successivement 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 : presser et relâcher la touche d'Échappement puis presser et maintenir la touche Contrôle enfoncée tout en pressant la touche x, puis les relâcher toutes les deux.

Sur certains claviers, la touche de modificateur Méta produit des caractères avec le huitième bit (0200) défini. Vous pouvez utiliser la variable enable-meta-key pour activer ou non cette possibilité, si le clavier le permet. Sur beaucoup d'autres claviers, le terminal ou l'émulateur de terminal convertit la touche précédée de Méta en une séquence de touches débutant par ESC comme décrit dans le paragraphe précédent.

Si votre touche Méta produit une séquence de touches avec le préfixe méta ESC, vous pouvez faire que le raccourci clavier M-touche (voir Raccourcis clavier readline) fasse la même chose en définissant la variable force-meta-prefix.

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) fait agir cette commande dans la direction opposée. Les commandes dont le comportement avec les arguments diffère de cela sont indiquées ci-dessous.

Le curseur (« point ») correspond à la position actuelle du curseur et la marque correspond à une position de curseur sauvegardée. Le texte entre le curseur et la marque est désigné comme la zone. readline possède le concept de zone active : quand la zone est active, l'affichage de readline met en surbrillance la zone en utilisant la valeur de la variable active-region-start-color. La variable enable-active-region active ou désactive cette fonction. Plusieurs commandes rendent la zone active ; elles sont noté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 effacements successifs accumulent le texte en un seul bloc qui peut être récupéré en une fois. Les commandes non destructives séparent les blocs de texte 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. Si ce fichier n'existe pas ou s'il ne peut pas être lu, readline cherche le fichier /etc/inputrc. Lorsqu'un programme utilisant la bibliothèque readline démarre, readline lit le fichier d'initialisation et les raccourcis clavier et les variables sont mis en place avant de lire toute entrée de l'utilisateur.

Seules quelques constructions élémentaires sont autorisées dans le fichier inputrc). 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 des commandes de raccourcis clavier dans le fichier inputrc. Les programmes qui utilisent la bibliothèque readline, y compris bash peuvent ajouter leurs propres commandes et raccourcis.

Par exemple, en plaçant

dans le fichier inputrc, fera que la séquence de touches M-C-u exécutera la commande readline universal-argument.

Les raccourcis clavier peuvent contenir les caractères symboliques suivants : DEL, ESC, ESCAPE, LFD, NEWLINE, RET, RETURN, RUBOUT (un espace arrière destructif), SPACE, SPC 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). La différence entre une macro et une commande est qu'une macro est encadrée par des guillemets simples ou doubles.

Raccourcis clavier readline¶

La syntaxe pour contrôler les 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 séquence de touches à laquelle il faut l'associer. La séquence de touches peut être indiquée de l'une de ces deux façons : comme un nom de touche symbolique, éventuellement précédé des préfixes Meta- ou Control- ou sous forme d'une séquence de touches d'un ou plusieurs caractères encadrés par des guillemets doubles. La séquence de caractères et le nom sont séparés par deux-points. Il ne peut pas y avoir d'espace entre le nom et les deux-points.

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

Control-u: universal-argument
Meta-Rubout: backward-kill-word
Control-o: "> output"

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 “> output” sur la ligne).

Avec la seconde forme, "suite_de_touches":nom_de_fonction ou macro, suite_de_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 séquences de touches d'échappement dans le style GNU Emacs peuvent être utilisées, comme dans l'exemple suivant, mais aucun des noms de caractères symboliques ne sont reconnus.

"\C-u": universal-argument
"\C-x\C-r": re-read-init-file
"\e[11~": "Function Key 1"

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 disponible pour spécifier des suites de touches 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 :

Lors de la saisie du 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 fonction. Les protections par contre-oblique décrites ci-dessus sont développées dans le corps de la macro. La contre-oblique protège tout autre caractère dans le texte de la macro, y compris " et '.

bash affichera ou modifiera les raccourcis clavier readline actuels avec la commande interne bind. Les options -o emacs ou *o vi de la commande set changent le mode d'édition pendant une utilisation interactive (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 variable non reconnus sont ignorés. Lorsque readline lit une valeur de variable, des valeurs vides ou NULL, “on” (insensible à la casse) et “1” sont équivalentes à On. Toutes les autres valeurs sont équivalentes à Off.

La commande bind -V liste le nom et la valeur des variables readline (consultez COMMANDES INTERNES DE L'INTERPRÉTEUR ci-dessous).

Les variables et leurs valeurs par défaut sont :

active-region-start-color

Une variable de chaîne qui contrôle la couleur du texte et du fond lors de l'affichage du texte dans la zone active (consultez la description de enable-active-region ci-dessous). Cette chaîne ne doit pas occuper l'emplacement d'un caractère physique quelconque sur l'affichage, aussi elle doit consister uniquement en séquences d'échappement du terminal. Elle est envoyée au terminal avant l'affichage du texte dans la zone active. Cette variable est remise à sa valeur par défaut chaque fois que le type de terminal change. La valeur par défaut est la chaîne qui place le terminal en mode standout telle qu'obtenue à partir de la description terminfo du terminal. Cette valeur pourrait être par exemple “\e[01;33m”.

active-region-end-color

Une variable de chaîne qui “undoes” (annule) les effets de active-region-start-color et rétablit l'apparence “normal” de l'affichage du terminal après l'affichage de texte dans la zone active. Cette chaîne ne doit pas occuper l'emplacement d'un caractère physique quelconque sur l'affichage, aussi elle doit consister uniquement en séquences d'échappement du terminal. Elle est envoyée au terminal après l'affichage du texte dans la zone active. Cette variable est remise à sa valeur par défaut chaque fois que le type de terminal change. La valeur par défaut est la chaîne qui rétablit le terminal à partir du mode standout telle qu'obtenue à partir de la description terminfo du terminal. Cette valeur pourrait être par exemple “\e[0m”.

bell-style (audible)

Cette variable contrôle le comportement quand readline veut 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 de 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 qui sont traités spécialement par le pilote de terminal du noyau à leurs équivalents readline. Cela outrepasse les associations de readline décrites ici. Entrez “stty -a” à une invite de bash pour voir les réglages actuels de votre terminal, y compris les caractères de contrôle spéciaux (habituellement cchars).

blink-matching-paren (Off)

Si configurée à On, readline tente de déplacer brièvement le curseur vers une parenthèse ouvrante lors de l'insertion d'une parenthèse fermante.

colored-completion-prefix (Off)

Si configurée à On, lors du listage des complètements, readline affiche le préfixe commun du jeu des complètements possibles en utilisant une couleur différente. Les définitions de couleur sont prises selon la valeur de la variable d’environnement LS_COLORS. S'il y a une définition de couleur dans $LS_COLORS pour le suffixe personnalisé “.readline-colored-completion-prefix”, readline utilise cette couleur pour le suffixe commun plutôt que la valeur par défaut.

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 (

“#”) La chaîne que la commande de readline insert-comment insère. Cette commande est associée à M-# en mode Emacs et à # en mode de commande vi.

completion-display-width (-1)

Le nombre de colonnes d'écran utilisées pour afficher de possibles correspondances lors de la réalisation du complètement. La valeur est ignorée si elle est inférieure à 0 ou supérieure à la largeur de l'écran du terminal. Une valeur de 0 fait que les correspondances seront affichées une par ligne. La valeur par défaut est -1.

completion-ignore-case (Off)

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

completion-map-case (Off)

Si configurée à On et completion-ignore-case activée, readline traite les traits d'union (-) et les tirets bas (_) comme équivalents lorsqu'elle réalise une recherche de correspondance et un complètement de nom de fichier insensibles à la casse.

completion-prefix-display-length (0)

La longueur maximale, 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 des points de suspension lors de l'affichage des complètements possibles. Si un complètement débute par un point et que readline complète des noms de fichier, il utilise trois tirets bas plutôt que des points de suspension.

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, readline demande à l'utilisateur s'il veut ou non les voir ; sinon, readline les liste simplement sur le terminal. Une valeur zéro signifie que readline ne le demandera jamais ; des valeurs négatives sont traitées comme un zéro.

convert-meta (On)

Si configurée à On, readline transforme les caractères qu'il lit et qui ont le huitième bit défini à une suite de caractères ASCII en supprimant le huitième bit et en le préfixant d'un caractère de protection (convertissant le caractère pour qu'il ait le préfixe méta). La configuration par défaut est On, mais readline la fixe à Off si le paramètre linguistique régional contient des caractères dont l'encodage peut inclure des octets avec le huitième bit défini. Cette variable dépend du paramètre linguistique régional LC_CTYPE et peut changer si le paramètre linguistique régional est modifié. Cette variable affecte aussi des raccourcis clavier ; voir la description de force-meta-prefix ci-dessous.

disable-completion (Off)

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

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.

editing-mode (emacs)

Commande si readline utilise un ensemble de raccourcis clavier similaires à Emacs ou à vi. editing-mode peut être positionné soit à emacs, soit à vi.

emacs-mode-string (@)

Si la variable show-mode-in-prompt est activée, cette chaîne est affichée immédiatement avant la dernière ligne de la première invite quand le mode édition d'Emacs est activé. La valeur est développée comme un raccourci clavier, donc le jeu standard de préfixes meta- ou Control- et de séquences de protections par contre-oblique est disponible. Les caractères de protection \1 et \2 ouvrent et ferment les séquences de caractères non imprimables, ce qui peut être utilisé pour inclure une suite de caractères de contrôle du terminal dans la chaîne de mode.

enable-active-region (On)

Quand cette variable est réglée à On, readline permet à certaines commandes de désigner la zone comme active. Quand la zone est active, readline surligne le texte en utilisant la valeur de la variable active-region-start-color qui est par défaut la chaîne qui active le mode standout du terminal. La région active montre le texte inséré par collage spécial (bracketed-paste) et tout texte correspondant trouvé lors de recherches incrémentales et non incrémentales dans l'historique.

enable-bracketed-paste (On)

Quand configurée à On, readline configurera le terminal pour pouvoir insérer chaque collage dans le tampon d'édition comme une chaîne de caractères unique, au lieu de traiter chaque caractère comme s'il avait été lu à partir du clavier. Cela s'appelle le mode bracketed-paste) et il empêche readline d'exécuter toute commande d'édition liée à des suites de touches apparaissant dans le texte collé.

enable-keypad (Off)

Quand configurée à On, readline essaye 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 essaye d'activer toutes les touches de modificateur Méta que le terminal peut prendre en charge. Sur de nombreux terminaux, la touche Méta est utilisée pour saisir des caractères sur huit bits ; cette variable vérifie la capacité du terminal qui indique que le terminal peut activer et désactiver un mode qui définit le huitième bit d'un caractère (0200) si la touche Méta est maintenue enfoncée quand le caractère est saisi (un caractère méta).

expand-tilde (Off)

Si configurée à On, readline effectue le développement du tilde lorsqu'il tente un complètement de commandes.

force-meta-prefix (Off)

Si configurée à On, readline modifie son comportement lors de la liaison de suites de touches contenant \M- ou Meta- (voir Raccourcis clavier ci-dessus) en convertissant une séquence de touches de la forme \M-C ou Meta-C en la suite de deux caractères ESC C (en ajoutant le préfixe méta). Si force-meta-prefix est configurée à Off valeur par défaut), readline utilise la valeur de la variable convert-meta pour déterminer s'il faut effectuer cette conversion : si convert-meta est On, readline effectue la conversion décrite ci-dessus ; si c'est Off, readline convertit C en un caractère méta en définissant le huitième bit (0200).

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 (unset)

Configure le nombre maximal d'éléments sauvegardés dans la file de l'historique. Si configuré à zéro, tous les éléments sont effacés et aucun nouvel élément n’est sauvegardé. Si configuré à une valeur strictement négative, le nombre d'éléments de la file d’historique n'est pas limité. Par défaut, bash définit le nombre maximal d’éléments à la valeur de la variable HISTSIZE de l'interpréteur. Définir history-size à une valeur non numérique, définira le nombre maximal d'éléments à 500.

horizontal-scroll-mode (Off)

La configuration de cette variable à On fait que 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. Ce réglage est activé automatiquement pour les terminaux de hauteur 1.

input-meta (Off)

Si configurée à On, readline accepte des saisies sur huit bits (autrement dit il ne supprime pas le huitième bit des caractères qu'il lit), sans tenir compte de ce que le terminal prétend pouvoir prendre en charge. La configuration par défaut est Off, mais readline la fixe à On si le paramètre linguistique régional contient des caractères dont l'encodage peut inclure des octets avec le huitième bit défini. Cette variable dépend du paramètre linguistique régional LC_CTYPE et peut changer si le paramètre linguistique régional est modifié. Le nom meta-flag est un synonyme de input-meta.

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 terminent 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 séquence 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 séquence de touches plus longue). Si readline ne reçoit aucune entrée pendant le temps d'attente, il utilise 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 attend la saisie d’une autre touche pour décider de la séquence de touches à compléter.

mark-directories (On)

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

mark-modified-lines (Off)

Si configurée à On, readline affiche les lignes d'historique qui ont été modifiées avec un astérisque en tête (*).

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 fichier. Si configurée à Off, l'utilisateur doit inclure le “.” du début dans le nom à 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 parcourir la liste.

output-meta (Off)

Si configurée à On, readline affiche directement les caractères ayant leur huitième bit défini plutôt que d'utiliser une suite de caractères de protection avec préfixe méta. La configuration par défaut est Off, mais readline la fixe à On si le paramètre linguistique régional contient des caractères dont l'encodage peut inclure des octets avec le huitième bit défini. Cette variable dépend du paramètre linguistique régional LC_CTYPE et peut être modifiée si le paramètre linguistique régional change.

page-completions (On)

Si configurée à On, readline utilise un pageur interne ressemblant à more pour afficher une pleine page de complètements.

prefer-visible-bell

Voir bell-style

print-completions-horizontally (Off)

Si configurée à On, readline affiche 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.

search-ignore-case (Off)

Si configurée à On, readline effectue les recherches incrémentales et non incrémentales dans la file d'historique sans tenir compte de la casse.

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 possible 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 une chaîne au début de l'invite indiquant le mode d’édition : Emacs, commande Vi ou insertion Vi. L'utilisateur peut configurer la chaîne de mode (par exemple, emacs-mode-string).

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 cours de complètement, ainsi les parties du mot situées après le curseur ne sont pas dupliquées.

vi-cmd-mode-string ((cmd))

Si la variable show-mode-in-prompt est activée, cette chaîne est affichée immédiatement avant la dernière ligne de la première invite quand le mode d'édition de vi est activé et en mode commande. La valeur est développée comme un raccourci clavier, donc le jeu standard de préfixes meta- ou Control- et de séquences de protections par contre-oblique est disponible. Les caractères de protection \1 et \2 ouvrent et ferment les séquences de caractères non imprimables, ce qui peut être utilisé pour inclure une suite de caractères de contrôle du terminal dans la chaîne de mode.

vi-ins-mode-string ((ins))

Si la variable show-mode-in-prompt est activée, cette chaîne est affichée immédiatement avant la dernière ligne de la première invite quand le mode d'édition de vi est actif et en mode insertion. La valeur est développée comme un raccourci clavier, donc le jeu standard de préfixes meta- ou Control- et de séquences de protections par contre-oblique est disponible. Les caractères de protection \1 et \2 ouvrent et ferment les séquences de caractères non imprimables, ce qui peut être utilisé pour inclure une suite de caractères de contrôle du terminal dans la chaîne de mode.

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 fichier 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 disponibles.

$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, après n’importe quel opérateur de comparaison, va jusqu'à la fin de la ligne ; sauf notation contraire, aucun caractère n'est nécessaire pour le délimiter.

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

$else

Les commandes dans cette branches de la directive $if sont exécutées si le test échoue.

$endif

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

$include

Cette directive prend un seul nom de fichier comme argument et y lit les commandes et les raccourcis clavier. 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é. Quand le mode d'édition d'Emacs est utilisé, la saisie de C-r recherche une chaîne particulière en arrière dans l'historique. La saisie de C-s recherche en avant dans l'historique. 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 ESC et C-j terminent une recherche incrémentale. C-g interrompt une recherche incrémentale et restaure 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 la combinaison C-r ou C-s appropriée. Cela recherche en avant ou en arrière dans l'historique l'élément suivant correspondant à la chaîne de recherche saisie jusqu'à présent. Toute autre séquence de touches associée à une commande readline interrompt la recherche et exécute la commande. Par exemple, un changement de ligne interrompt la recherche et accepte la ligne, exécutant ainsi la commande de la file d'historique. Une commande de déplacement va terminer la recherche, faire de la dernière ligne trouvée la ligne actuelle et débuter l'édition.

readline se souvient de la dernière chaîne de recherche incrémentale. Si deux C-r sont saisis sans caractère pour définir une nouvelle chaîne de recherche, readline utilise toute chaîne mémorisée.

Les recherches non incrémentales lisent la chaîne désirée en entier avant de démarrer la recherche de correspondance dans les entrées 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 séquences de touches auxquelles elles sont associées par défaut. Les noms de commande sans séquence de touches 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. readline possède le concept de zone active : quand la zone est active, l'affichage de readline met en surbrillance la zone en utilisant la valeur de la variable active-region-start-color. La variable enable-active-region active ou désactive cette fonction. Plusieurs commandes rendent la zone active ; elles sont notées ci-dessous.

Commandes de déplacement¶

beginning-of-line (C-a)

Reculer au début de la ligne actuelle. Sur certains claviers, ce déplacement peut aussi être lié à la touche Début.

end-of-line (C-e)

Avancer à la fin de la ligne. Sur certains claviers, ce déplacement peut aussi être lié à la touche Fin.

forward-char (C-f)

Avancer d'un caractère. Sur certains claviers, ce déplacement peut aussi être lié à la touche flèche vers la droite.

backward-char (C-b)

Reculer d'un caractère. Sur certains claviers, ce déplacement peut aussi être lié à la touche flèche vers la gauche.

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 (M-C-f)

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 (M-C-b)

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.

previous-screen-line

Tenter de déplacer le curseur vers la même colonne physique de l'écran sur la ligne physique précédente de l'écran. Cela n'aura pas l'effet désiré si la ligne actuelle de readline n'accepte pas plus d'une ligne physique ou si la position du curseur n'est pas supérieure à la longueur de l'invite plus la largeur de l'écran.

next-screen-line

Tenter de déplacer le curseur vers la même colonne physique de l'écran sur la physique ligne suivante de l'écran. Cela n'aura pas l'effet désiré si la ligne actuelle de readline n'accepte pas plus d'une ligne physique ou si la longueur de la ligne actuelle de readline n'est pas supérieure à la longueur de l'invite plus la largeur de l'écran.

clear-display (M-C-l)

Effacer l'écran et, si possible, le tampon de défilement du terminal, puis rafraîchir la ligne actuelle, en laissant la ligne actuelle au sommet de l'écran.

clear-screen (C-l)

Effacer l'écran, puis rafraîchir la ligne actuelle, en laissant la ligne actuelle au sommet de l'écran. S'il y a un argument numérique, 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, en fonction de l'état des variables HISTCONTROL et HISTIGNORE. 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. Sur certains claviers, cette action peut aussi être liée à la touche flèche vers le haut.

next-history (C-n)

Récupérer la commande suivante dans la file d'historique, en descendant dans la file. Sur certains claviers, cette action peut aussi être liée à la touche flèche vers le bas.

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.

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

Valider la ligne actuelle pour exécution comme si une nouvelle ligne avait été saisie et récupérer depuis l'historique la ligne suivante liée à la ligne actuelle pour édition. Si un argument numérique est fourni, il spécifie l'entrée de l'historique à utiliser à la place de la ligne actuelle.

fetch-history

Avec argument numérique, récupérer cette entrée de la file d'historique et en faire la ligne actuelle. Sans argument, revenir à la première entrée de la file d'historique.'

reverse-search-history (C-r)

Rechercher en arrière en partant de la ligne actuelle, en remontant ( “up” ) dans l'historique autant que nécessaire. C'est une recherche incrémentale. Cette commande définit la zone du texte correspondant et active la zone.

forward-search-history (C-s)

Rechercher en avant en partant de la ligne actuelle en descendant ( “down” ) dans l'historique autant que nécessaire. C'est une recherche incrémentale. Cette commande définit la zone du texte correspondant et active la zone.

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

Rechercher une chaîne en arrière dans l'historique, en remontant depuis la ligne actuelle, en utilisant une recherche non incrémentale pour une chaîne fournie par l'utilisateur. La chaîne recherchée peut trouver une correspondance n'importe où dans une ligne de l'historique.

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

Rechercher une chaîne en avant dans l'historique, en utilisant une recherche non incrémentale pour une chaîne fournie par l'utilisateur. La chaîne recherchée peut trouver une correspondance n'importe où dans une ligne de l'historique.

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. La chaîne recherchée peut trouver une correspondance au début d'une ligne de l'historique. C'est une recherche non incrémentale. Sur certains claviers, cette action peut être liée à la touche page précédente.

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. La chaîne recherchée peut trouver une correspondance au début d'une ligne de l'historique. C'est une recherche non incrémentale. Sur certains claviers, cette action peut être liée à la touche page suivante.

history-substring-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. La chaîne recherchée peut trouver une correspondance n'importe où dans une ligne de l'historique. C'est une recherche non incrémentale.

history-substring-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. La chaîne recherchée peut trouver une correspondance n'importe où dans une ligne de l'historique. 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 l'argument n traité, les outils de développement d'historique sont utilisés pour extraire le nième mot 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 la ligne en effectuant le développement de mot de l'interpréteur, Cela effectue le développement des alias et d'historique, la protection par $'chaîne' et $"chaîne", le développement de tilde, le développement des paramètres et des variables, le développement arithmétique, la substitution de commande et de processus, le découpage en mots et la suppression des protections, Un argument explicite supprime la substitution de commande et de processus. 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 de l'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.

edit-and-execute-command (C-x C-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 fichier (EOF) est défini, par exemple, par stty(1). 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 la 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. Sur certains claviers, cela peut aussi être lié à la touche Suppression.

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 saisi.

bracketed-paste-begin

Cette fonction est destinée à être liée à la suite de caractères de protection “bracketed paste” (collage spécial) envoyée par certains terminaux, et une telle liaison est affectée par défaut. Elle permet à readline d'insérer le texte collé comme une seule unité sans traiter chaque caractère comme s'il avait été lu à partir du clavier. Les caractères collés sont insérés comme si chacun était lié à self-insert plutôt que d'exécuter des commandes d'édition.

Le collage spécial (bracketed paste) définit la zone sur le texte inséré et active la zone.

transpose-chars (C-t)

Déplacer le caractère avant le curseur au-delà du caractère sous le curseur, et déplacer aussi le curseur. Si le curseur est à la fin de la 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éplacer le mot avant le curseur au-delà du mot après le curseur et déplacer aussi le curseur au-delà de ce mot. Si le curseur est à la fin de la ligne, cela échange les deux derniers mots de la ligne.

shell-transpose-words (M-C-t)

Déplacer le mot avant le curseur au-delà du mot après le curseur et déplacer aussi le curseur après ce mot. Si le point d'insertion est à la fin de la ligne, cela échange les deux derniers mots de la ligne. Les limites de mots sont identiques à celles utilisées par shell-forward-word et shell-backward-word.

upcase-word (M-u)

Transformer le mot actuel (ou le suivant) en capitales. 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 le mot actuel (ou du suivant) en capitales. 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, basculer en mode d'écrasement. Avec un argument numérique explicite négatif ou nul, basculer 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, mais sur certains claviers, elle peut être associée à la touche Insertion.

Effacement et récupération¶

kill-line (C-k)

Effacer le texte du curseur à la fin de la ligne actuelle. Avec un argument numérique négatif, effacer en arrière du curseur au début de la ligne.

backward-kill-line (C-x Effacement)

Effacer en arrière jusqu'au début de la ligne actuelle. Avec un argument numérique négatif, effacer du curseur à la fin de la ligne.

unix-line-discard (C-u)

Effacer le texte entre le début de la ligne et la position du curseur en sauvegardant le texte effacé 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-C-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

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 un espace blanc comme limite de mot en sauvegardant le texte effacé dans le tampon circulaire.

unix-filename-rubout

Effacer le mot sous le curseur, en utilisant un espace blanc et la barre oblique comme limites de mot en sauvegardant le texte effacé dans le tampon circulaire.

delete-horizontal-space (M-\)

Effacer toutes les espaces et 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 afin qu'il puisse être copié immédiatement.

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 d'un caractère qui n'est ni un chiffre ni le signe moins, le compteur d'arguments de la commande suivante est multiplié par quatre. 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 tente le complètement en vérifiant d'abord s'il y a des complètements programmables pour le mot de la commande (consultez Complètement programmable ci-dessous), sinon 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, les fonctions et les commandes internes). Si aucun ne correspond, un complètement de fichier est essayé.

possible-completions (M-?)

Afficher les complètements possibles du texte situé avant le curseur. Lors de l'affichage des complètements, readline définit le nombre de colonnes utilisées pour l'affichage à la valeur de completion-display-width, à celle de la variable de l'interpréteur COLUMNS ou à la largeur de l'écran, dans cet ordre.

insert-completions (M-*)

Insérer l'ensemble des complètements du texte situé avant le curseur qui auraient été produits par possible-completions, séparés par une espace.

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, menu-complete émet une alarme (selon la configuration de bell-style) et restaure le texte original. 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.

export-completions

Effectuer un complètement du mot situé avant le curseur comme décrit ci-dessus et écrire la liste des complètements possibles sur le flux de sortie de readline en utilisant le format suivant, en écrivant les informations sur des lignes distinctes :

S'il n'y a pas de correspondance, la première ligne sera “0”, et cette commande n'affiche aucune sortie après le S:E. S'il n'y a qu'une correspondance, la commande affiche une seule ligne qui la contient. S'il y a plus d'une correspondance, la commande affiche le préfixe commun des correspondances, qui peut être vide, sur la première ligne après le S:E, puis les correspondances sur les lignes suivantes. Dans ce cas, N inclura la première ligne avec le préfixe commun.

L'utilisateur ou l'application doit être capable de gérer une ligne vide. Le but est que l'utilisateur ou l'application lise N lignes après la ligne qui contient S:E pour obtenir la liste de correspondances. 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, cette commande 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 fichier sur le texte situé avant le curseur.

possible-filename-completions (C-x /)

Afficher les complètements possibles du texte situé avant le curseur, en le traitant 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, aux mots réservés, aux fonctions de l'interpréteur, aux commandes internes de l'interpréteur et finalement aux 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 entrées de la file d'historique lui correspondant pour les complètements possibles.

dabbrev-expand

Essayer le complètement de menu 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 de noms de fichier 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 des caractères saisis dans la macro clavier en cours.

end-kbd-macro (C-x ))

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

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

Réexécuter la dernière macro clavier 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 les 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-lowercase-version (M-A, M-B, M-x, ...)

Si le caractère x précédé de Méta est en capitale, exécuter la commande qui est associée aux caractères minuscules précédés de Méta correspondants. Le comportement est non défini si x est déjà en minuscule.

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, Poser la marque à la position correspondante.

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

Échanger le curseur et la marque. Configurer la position actuelle du curseur à la position sauvegardée précédemment puis poser la marque à l'ancienne position du curseur.

character-search (C-])

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

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

Lire un caractère et déplacer le curseur à 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 à “\e[”, les touches qui produisent des suites SCI 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. La commande n'est associée à aucune touche par défaut, mais elle est souvent associée à ESC [.

insert-comment (M-#)

Sans argument numérique, insérer la valeur de la variable comment-begin de readline 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, insérer la valeur, sinon effacer les caractères de comment-begin 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 en commentaire de l'interpréteur. Si un argument numérique conduit à l'effacement du caractère de commentaire, la ligne sera exécutée par l'interpréteur.

spell-correct-word (C-x s)

Effectuer la correction orthographique sur le mot actuel, en le traitant comme un répertoire ou un nom de fichier, de la même manière que l'option de l'interpréteur cdspell. Les limites des mots sont identiques à celles utilisées par shell-forward-word.

glob-complete-word (M-g)

Traiter le mot avant le curseur comme un motif pour un développement de chemin, avec un astérisque ajouté implicitement, puis utiliser ce motif pour produire une liste de noms de fichier correspondants pour de possibles complètements.

glob-expand-word (C-x *)

Traiter le mot précédant le curseur comme un motif pour un développement de chemin et insérer la liste de noms de fichier correspondants à sa place. Si un argument numérique est fourni, ajouter un * avant le développement du chemin.

glob-list-expansions (C-x g)

Afficher la liste des développements qui auraient été produits par glob-expand-word et rafraîchir la ligne. Si un argument numérique est fourni, ajouter un * avant 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 séquences de touches readline associées à des macros et les chaînes auxquelles elles correspondent 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.

execute-named-command (M-x)

Lire à partir de l'entrée un nom de commande readline pouvant être liée et exécuter la fonction à laquelle elle est associée, comme si la suite de touches à laquelle elle a été associée apparaissait sur l'entrée. Si cette fonction est fournie avec un argument numérique, la commande passe cet argument à la fonction qu'elle exécute;

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

Afficher des informations sur la version actuelle de bash.

Complètement programmable¶

Lorsqu'un utilisateur tente un complètement de mot pour une commande ou un argument pour 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), readline appelle les outils de complètement programmable.

Tout d'abord, bash identifie le nom de la commande. 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 une chaîne vide (le complètement est tenté au début d'une ligne vide), bash utilise toute spécification définie par l'option -E de complete. L'option -I de complete indique que le mot de commande est le premier mot de non-affectation de la ligne ou celui après un délimiteur de commande tel que ; ou |. Cela indique habituellement le complètement d'un nom de commande

Si le mot de commande est un chemin d'accès complet, bash cherche en premier lieu une spécification de complètement pour le chemin d'accès complet. S'il n'existe pas de spécification de complètement pour le chemin d'accès complet, bash tente de trouver une spécification de complètement pour la partie située après la barre oblique finale. Si ces recherches ne donnent pas de résultat sous forme de spécification de complètement, ou s'il n'y a pas de spécification de complètement pour le mot de commande. bash utilise toutes les spécifications de complètement définies par l'option -D de complete par défaut. S'il n'existe pas de spécification de complètement par défaut, bash effectue un développement d'alias sur le mot de commande en dernier ressort et tente de trouver une spécification de complètement pour le mot de commande résultant de n'importe quel développement ayant réussi.

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

Tout d'abord, bash effectue les actions définies par la spécification de complètement. Cela renvoie uniquement les correspondances qui sont des préfixes du mot à compléter. Lorsque l'option -f ou -d est utilisée pour le complètement des noms de fichier ou de répertoire, bash utilise la variable d'interpréteur FIGNORE pour filtrer les correspondances.

Ensuite, le complètement programmable crée les correspondances indiquées par le motif de développement des chemins fourni comme argument à l'option -G. Il n'est pas nécessaire que les mots produits par le motif correspondent au mot à compléter. bash utilise la variable FIGNORE pour filtrer les correspondances, mais n'utilise pas la variable de l'interpréteur GLOBIGNORE.

Ensuite, le complètement prend en compte la chaîne indiquée comme argument à l'option -W. Cette chaîne est tout d'abord découpée en utilisant les caractères de la variable spéciale IFS comme délimiteurs. Cela respecte les protections de l'interpréteur à l'intérieur de la chaîne afin de fournir un mécanisme pour que les mots puissent contenir des métacaractères ou des mots de l'interpréteur dans la valeur de IFS. 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 des complètements possibles.

Après la création de ces correspondances, bash exécute toute fonction de l'interpréteur ou commande indiquée avec les options -F et -C. Lorsque la commande ou la fonction est appelée, bash affecte des valeurs aux variables COMP_LINE, COMP_POINT, COMP_LINKEY et COMP_POINTYPE 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. Il n'y a pas de filtrage des complètements produits pour le mot à compléter ; la fonction ou la commande ont toute liberté dans la production des correspondances et il n'est pas nécessaire qu'elles correspondent à un préfixe du mot.

Toute fonction indiquée avec -F est appelée en premier. La fonction peut utiliser tous les outils de l'interpréteur, incluant les commandes internes compgen et compopt décrites ci-dessous, pour produire les correspondances. Elle doit mettre les complètements possibles dans la variable tableau COMPREPLY, un 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 doit afficher une liste des complètements possibles, un par ligne, sur la sortie standard. Si nécessaire, une contre-oblique va protéger un caractère de changement de ligne. Ils sont ajoutés à l'ensemble des complètements possibles.

Après la création de tous les complètements possibles, bash applique tout filtre, indiqué avec l'option -X, aux complètements de 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 est supprimé de la liste. Un ! au début du motif provoque la négation de ce motif ; dans ce cas, bash supprime tout complètement qui ne correspond pas au motif. Si l'option d'interpréteur nocasematch est activée, bash effectue la mise en correspondance sans tenir compte de la casse des caractères alphabétiques.

Finalement, la complétion programmable ajoute tout préfixe et suffixe indiqués avec les options -P et -S respectivement à chaque complètement et renvoie le résultat à 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, bash tente le complètement des noms de répertoire.

Si l'option -o plusdirs a été fournie à complete lors de la définition de la spécification de complètement, bash tente le complètement des noms de répertoire et ajoute toute correspondance à l'ensemble des complètements possibles.

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 et le complètement de nom de fichier par défaut de readline sont désactivés. Si l'option -o bashdefault a été fournie à complete lors de la définition de la spécification de complètement et que la spécification de complètement ne produit pas de correspondance, bash tente ses complètements par défaut. Si la spécification de complètement et, s'ils sont tentés, les complètements par défaut de bash ne produisent pas de correspondance et si l'option -o default a été fournie à complete lors de la définition de la spécification de complètement, le complètement programmable effectue le complètement par défaut de readline.

Les options fournies à complete et compopt peuvent contrôler la manière dont readline traite les complètements. Par exemple, l'option -o fullquote fait que readline protège les correspondances comme s'il s'agissait de noms de fichier. Voir la description de complete ci-dessous pour des détails.

Lorsqu'une spécification de complètement indique qu'elle veut un complètement de nom de répertoire, 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ées comme fonctions de complètement permettent d'annoncer que le complètement doit être réessayé en renvoyant un code de retour 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. Cela peut être utilisé pour construire un jeu de complètements dynamiquement lorsque le complètement est essayé, plutôt que de les charger tous en même temps.

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 qui suit chargerait les complètements de façon dynamique :

_completion_loader()
{


  . "/etc/bash_completion.d/$1.sh".if  0<80n \


>/dev/null 2>&1 && return 124
}
complete -D -F _completion_loader.if  0<80n \


-o bashdefault -o default

Indicateur d'événement¶

Un indicateur d'événement est une référence à un élément dans la file d'historique. L'indicateur d'événement consiste en la partie du mot qui commence par le caractère de développement d'historique et se termine par l'indicateur de mot s'il existe ou la fin du mot. 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 d'un blanc, d'un changement de ligne, d'un retour chariot, d'un = ou lorsque l'option d'interpréteur extglob est activée en utilisant la commande interne shopt, d'un (.

!n

Fait référence à l'entrée n de la file d'historique.

!-n

Fait référence à l'entrée actuelle moins n.

!!

Fait référence à l'entrée précédente. C'est un synonyme de “!-1”.

!chaîne

Fait référence à la commande la plus récente précédant la position actuelle dans la file d'historique commençant par chaîne.

!?chaîne[?]

Fait référence à la commande la plus récente précédant la position actuelle dans la file d'historique contenant chaîne. Le ? final peut être omis si chaîne est immédiatement suivie d'un changement de ligne. Si chaîne est absente, cela utilise la chaîne de la dernière recherche ; c'est une erreur s'il n'y a pas de chaîne de recherche précédente.

^chaîne_1^chaîne_2^

Substitution rapide, répète la commande précédente en remplaçant chaîne_1 par chaîne_2. Équivalent à “!!:s^string1^string2^” (consultez Modificateurs ci-dessous)

!#

La ligne de commande entière saisie jusqu'à présent.

Indicateurs de mots¶

Les indicateurs de mots servent à sélectionner les mots désirés dans un événement. Ils sont facultatifs ; si l'indicateur de mot n'est pas fourni, le développement d'historique utilise l'événement en entier. Un : sépare l'indicateur d'événement de l'indicateur de mots. On peut l'omettre si l'indicateur de mots 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 uniques.

0 (zéro)

Le zéroième mot. Pour l'interpréteur, c'est le mot de la commande.

n

Le n-ième mot.

^

Le premier argument : le mot 1.

$

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

%

Le premier mot correspondant à la recherche “?string?” la plus récente, si la chaîne de recherche débute par un caractère qui fait partie d'un mot. Par défaut, les recherches commencent par la fin de chaque ligne et continuent jusqu'au début, ainsi le premier mot correspondant est celui qui est le plus près de la fin de la ligne.

x-y

Un intervalle de mots ; “-y” Abréviation de “0-y”.

*

Tous les mots sauf le zéroième. C'est un synonyme de “1-$”. Il n'est pas erroné d'utiliser * s'il n'y a qu'un mot dans l'événement ; il se développe en une chaîne vide dans ce cas.

x*

Abréviation de x-$.

x-

Abréviation de x-$ comme x*, mais sans le dernier mot. Si x est absent, la valeur par défaut est 0.

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

Modificateurs¶

Après un indicateur de mot facultatif, le développement peut inclure une suite d'un ou plusieurs des modificateurs suivants, chacun précédé d'un “:”. Cela modifie ou corrige le ou les mots sélectionnés à partir de l'événement de l'historique.

h

Supprimer la fin d'un 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 d'autres substitutions.

x

Protéger les mots substitués comme avec q, mais avec séparation des mots aux blancs et changements de ligne. Les modificateurs q et x s'excluent mutuellement ; le développement utilise le dernier fourni.

s/ancien/nouveau/

Remplacer par nouveau la première occurrence de ancien sur la ligne d'événement. Tout caractère peut être utilisé comme délimiteur à la place de /. Le dernier délimiteur est facultatif si c'est le dernier caractère de la ligne d'événement. Une seule contre-oblique peut protéger le délimiteur dans ancien et nouveau . Si & apparaît dans nouveau, il est remplacé par ancien. Une seule contre-oblique protège 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[?]. Si nouveau est NULL, chaque correspondance à ancien est supprimée.

&

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

g

Appliquer les modifications sur toute la ligne d'événement. C'est utilisé conjointement avec “:s” (par exemple, “:gs/old/new/”) 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énement. Un a peut être utilisé en tant que synonyme de g.

G

Appliquer une fois le modificateur “s” ou “&” à tous les mots de la ligne d'événement.