Function |
Fonction |
|---|---|
| VBScript | |
Syntaxe
|
[FunctionType] Function NameOfFunction(ArgumentsOfFunction) VBScript-statement NameOfFunction = ReturnValueOfFunction End Function |
Paramètres
| Nom | Description |
|---|---|
| NameOfFunction | Ce paramètre permet d'indiquer le nom de la fonction. Le même nom doit être utilisé pour retourner la valeur de la fonction. |
| VBScript-statement | Ce paramètre permet d'indiquer les instructions contenu dans la fonction. |
| NameOfFunction | Ce paramètre permet d'indiquer la valeur a retourner par la fonction. |
| ArgumentsOfFunction | Ce paramètre permet d'indiquer les paramètres de la fonction. |
Description
Ce mot réservé permet de définir une fonction.
Remarques
- Une Function en VBScript est un bloc de code réutilisable effectuant un traitement et retourne une valeur. Elle se distingue des procédures Sub qui, elles, ne renvoient aucun résultat. Cela permet d'intégrer des calculs ou vérifications dans un flux logique de script.
- Le nom de la fonction (NameOfFunction) est utilisé non seulement pour appeler la fonction, mais aussi pour assigner la valeur de retour. C'est une particularité de VBScript : on assigne le résultat directement à son propre nom à l'intérieur de la fonction.
- Les paramètres (ArgumentsOfFunction) permettent de personnaliser l'exécution de la fonction en lui transmettant des données dynamiques. Une même fonction peut donc produire des résultats différents selon les valeurs reçues en paramètre.
- Une fonction peut être déclarée avec un modificateur d'accès (FunctionType) comme Public ou Private, principalement dans un contexte de modularisation ou d'encapsulation (notamment dans des environnements HTA ou des classes VBScript).
- Le mot clef End Function est indispensable pour clôturer la définition de la fonction. Cela délimite clairement le bloc d'instructions à exécuter et évite que d'autres parties du code soient interprétées comme faisant partie de la fonction.
- Les fonctions sont souvent utilisées pour centraliser des calculs, comme le traitement de données, la validation d'entrées utilisateur ou la génération de valeurs. Cela permet de gagner en lisibilité et maintenance du script.
- Il est possible d'appeler une fonction depuis n'importe quelle partie du script, tant qu'elle est définie avant ou que le fichier entier est analysé avant exécution. Cela offre une grande liberté dans l'organisation du code.
- Une bonne pratique consiste à bien commenter l'intérieur des fonctions et à choisir des noms explicites, car une fonction trop complexe ou mal nommée peut rapidement nuire à la compréhension globale du script. Une fonction = une action claire.
Dernière mise à jour : Lundi, le 19 Avril 2021