Vérifier le nombre d'arguments passés à un script Bash

Je voudrais que mon script Bash affiche un message d'erreur si le nombre d'arguments requis n'est pas atteint.

J'ai essayé le code suivant:

#!/bin/bash
echo Script name: $0
echo $# arguments 
if [$# -ne 1]; 
    then echo "illegal number of parameters"
fi

Pour une raison inconnue, j'ai l'erreur suivante:

test: line 4: [2: command not found

Qu'est-ce que je fais mal?

Comme toute autre commande simple, [ ... ]ou testnécessite des espaces entre ses arguments.

if [ "$#" -ne 1 ]; then
    echo "Illegal number of parameters"
fi

Ou

if test "$#" -ne 1; then
    echo "Illegal number of parameters"
fi

Suggestions

Lorsque vous êtes dans Bash, préférez utiliser à la [[ ]]place car il ne fait pas de fractionnement de mot et d'expansion de nom de chemin à ses variables que la citation peut ne pas être nécessaire sauf si elle fait partie d'une expression.

[[ $# -ne 1 ]]

Il possède également d'autres fonctionnalités telles que le regroupement de conditions sans guillemets, la correspondance de modèles (correspondance de modèles étendue avec extglob) et la correspondance d'expressions régulières.

L'exemple suivant vérifie si les arguments sont valides. Il permet un seul argument ou deux.

[[ ($# -eq 1 || ($# -eq 2 && $2 == <glob pattern>)) && $1 =~ <regex pattern> ]]

Pour pures expressions arithmétiques, en utilisant (( ))à certains peuvent encore être mieux, mais ils sont encore possibles dans [[ ]]ses opérateurs arithmétiques comme -eq, -ne, -lt, -le, -gtou -geen plaçant l'expression comme un seul argument de chaîne:

A=1
[[ 'A + 1' -eq 2 ]] && echo true  ## Prints true.

Cela devrait être utile si vous devez également le combiner avec d'autres fonctionnalités de [[ ]].

Quitter le script

Il est également logique de quitter le script lorsque des paramètres non valides lui sont transmis. Cela a déjà été suggéré dans les commentaires par ekangas mais quelqu'un a édité cette réponse pour l'avoir -1comme valeur retournée, donc je ferais aussi bien de le faire correctement.

-1bien qu'accepté par Bash comme argument, il exitn'est pas explicitement documenté et ne peut être utilisé comme suggestion courante. 64est également la valeur la plus formelle car elle est définie sysexits.havec #define EX_USAGE 64 /* command line usage error */. La plupart des outils comme lsreviennent également 2sur des arguments invalides. J'avais aussi l'habitude de revenir 2dans mes scripts mais dernièrement je ne m'en souciais plus vraiment, et j'utilisais simplement 1dans toutes les erreurs. Mais plaçons-nous 2ici car c'est le plus courant et probablement pas spécifique au système d'exploitation.

if [[ $# -ne 1 ]]; then
    echo "Illegal number of parameters"
    exit 2
fi

Références

• Expressions conditionnelles Bash
• Constructions conditionnelles
• Correspondance de motifs
• Fractionnement de mots
• Extension de nom de fichier (extension de nom de chemin d'accès précédente)
• Commandes simples

Il pourrait être judicieux d'utiliser des expressions arithmétiques si vous avez affaire à des nombres.

if (( $# != 1 )); then
    echo "Illegal number of parameters"
fi

Sur [] :! =, =, == ... sont des opérateurs de comparaison de chaînes et -eq, -gt ... sont des opérateurs binaires arithmétiques .

J'utiliserais:

if [ "$#" != "1" ]; then

Ou:

if [ $# -eq 1 ]; then

Si vous n'êtes intéressé par le baillage que si un argument particulier est manquant, la substitution de paramètres est idéale:

#!/bin/bash
# usage-message.sh

: ${1?"Usage: $0 ARGUMENT"}
#  Script exits here if command-line parameter absent,
#+ with following error message.
#    usage-message.sh: 1: Usage: usage-message.sh ARGUMENT

Un simple liner qui fonctionne peut être fait en utilisant:

[ "$#" -ne 1 ] && ( usage && exit 1 ) || main

Cela se décompose en:

1. tester la variable bash pour la taille des paramètres $ # n'est pas égal à 1 (notre nombre de sous-commandes)
2. si vrai, appelez la fonction use () et quittez avec le statut 1
3. sinon, appelez la fonction main ()

Pense à noter:

• usage () peut être simplement un écho "$ 0: params"
• main peut être un long script

Découvrez cette feuille de triche bash, il peut aider beaucoup.

Pour vérifier la longueur des arguments transmis, vous utilisez "$#"

Pour utiliser le tableau d'arguments transmis, vous utilisez "$@"

Un exemple de vérification de la longueur et d'itération serait:

myFunc() {
  if [[ "$#" -gt 0 ]]; then
    for arg in "$@"; do
      echo $arg
    done
  fi
}

myFunc "$@"

Ce stage m'a aidé, mais il manquait quelques choses pour moi et ma situation. J'espère que cela aide quelqu'un.

Au cas où vous voudriez être du bon côté, je recommande d'utiliser des getopts.

Voici un petit exemple:

    while getopts "x:c" opt; do
      case $opt in
        c)
          echo "-$opt was triggered, deploy to ci account" >&2
          DEPLOY_CI_ACCT="true"
          ;;
            x)
              echo "-$opt was triggered, Parameter: $OPTARG" >&2 
              CMD_TO_EXEC=${OPTARG}
              ;;
            \?)
              echo "Invalid option: -$OPTARG" >&2 
              Usage
              exit 1
              ;;
            :)
              echo "Option -$OPTARG requires an argument." >&2 
              Usage
              exit 1
              ;;
          esac
        done

voir plus de détails ici par exemple http://wiki.bash-hackers.org/howto/getopts_tutorial

Voici un simple liners pour vérifier si un seul paramètre est donné sinon quittez le script:

[ "$#" -ne 1 ] && echo "USAGE $0 <PARAMETER>" && exit

Vous devez ajouter des espaces entre les conditions de test:

if [ $# -ne 1 ]; 
    then echo "illegal number of parameters"
fi

J'espère que ça aide.