Créer une fonction dans un script Batch

Vous n’avez pas besoin d’écrire un code pour la même tâche encore et encore si vous créez une fonction pour cette tâche spécifique. Cet article explique comment créer une fonction dans Batch Script.

Créer une fonction dans un Batch Script

Le format général de création d’une fonction est illustré ci-dessous.

:function_name

Et le format général pour appeler cette fonction est d’utiliser un mot-clé CALL avec :function_name, comme celui ci-dessous.

CALL :function_name

Voyons maintenant quelques exemples avec des explications appropriées pour faciliter la compréhension.

Dans notre exemple ci-dessous, nous venons de créer une fonction qui imprime le message Hello! C'est la fonction.... Notre code pour cet exemple ressemblera à ceci :

@echo off
CALL :showmessage
EXIT /B %ERRORLEVEL%

:showmessage
ECHO Hello! It's the function...
EXIT /B 0

Vous pouvez remarquer que nous avons écrit la ligne EXIT /B %ERRORLEVEL%. Cette ligne vise à quitter le programme après que la fonction a fait son travail ; sinon, le programme continuera à exécuter la fonction.

Et la ligne EXIT /B 0 a été créée pour sortir de la fonction.

Après avoir exécuté le code, vous obtiendrez la sortie ci-dessous.

Production:

Hello! It's the function...

Appeler une fonction avec des paramètres

Dans notre prochain exemple, nous appellerons une fonction avec des paramètres.

Le format général d’appel d’une fonction est illustré ci-dessous :

CALL :function_name %parameter%

Et le paramètre est accessible à l’intérieur de la fonction en utilisant l’index des paramètres comme %~1.

Notre code pour l’exemple ressemblera à ceci :

@echo off
SET FuncVar=10
CALL :showvar %FuncVar%
EXIT /B %ERRORLEVEL%

:showvar
ECHO Your passed variable is %~1
EXIT /B 0

Dans l’exemple, nous avons déclaré une variable nommée FuncVar avec la valeur 10. Ensuite, nous avons appelé la fonction et passé cette variable en tant que paramètre.

Dans la fonction, nous venons d’imprimer le paramètre passé à la fonction. Maintenant, la sortie sera comme suit.

Production:

Your passed variable is 10

Appeler une fonction avec plusieurs paramètres

Lorsque vous travaillez avec plusieurs paramètres, vous devez suivre le format ci-dessous :

CALL :function_name %parameter1% %parameter2% %parameter3%

Dans notre exemple suivant, nous avons passé plusieurs variables en tant que paramètres dans la fonction. L’exemple de code sera,

@echo off
SET FuncVar1=10
SET FuncVar2=50
CALL :showvar %FuncVar1% %FuncVar2%
EXIT /B %ERRORLEVEL%

:showvar
ECHO Your 1st parameter is %~1
ECHO Your 2nd parameter is %~2
EXIT /B 0

Vous pouvez remarquer que nous avons accédé à deux paramètres en fonction de l’index des paramètres comme %~1 et %~2. Après avoir exécuté le code, vous obtiendrez la sortie suivante.

Production:

Your 1st parameter is 10
Your 2nd parameter is 50