Sous-routines et fonctions

Sous-routines et fonctions VBScript

Cette section fournit une vue d’ensemble de l’utilisation des sous-routines et des procédures dans les scripts VisualBasic d’Altum Designer.

Passage de paramètres aux procédures

Lorsqu’une fonction ou une sous-routine (une procédure/méthode) pouvant accepter des paramètres est définie dans un script, les variables peuvent être transmises à la fonction ou à la sous-routine de deux façons : par référence ou par valeur, en utilisant ByRef ou ByVal respectivement.

Pour déclarer la méthode de passage des paramètres, utilisez les mots-clés ByRef ou ByVal dans la liste des paramètres lors de la définition de la fonction ou de la sous-routine dans une instruction Sub ou Function. Par exemple, le fragment de code suivant définit une sous-routine qui accepte deux paramètres. Le premier est passé par valeur et le second par référence :

Sub Test (ByVal Param1 As Integer , ByRef B As String)

La différence entre les deux méthodes est que ByRef transmet une référence à la variable et permet à la sous-routine/fonction d’apporter des modifications à la variable réelle passée en paramètre. Il s’agit de la méthode par défaut de passage des paramètres, utilisée si la méthode n’est pas explicitement déclarée.

ByVal transmet uniquement la valeur de la variable. La sous-routine ou la fonction peut utiliser cette valeur, mais la variable d’origine transmise n’est pas modifiée.

Les exemples suivants illustrent les différences entre ces méthodes. La procédure principale est la suivante :

Sub Main
  Dim X, Y
  X = 45 : Y = "Number"
  Test X, Y   ' Call to a subprocedure called Test.
  MsgBox X
   MsgBox Y
End Sub

La procédure ci-dessus inclut un appel à une sous-procédure Test — voir ci-dessous.

Si la sous-routine est définie comme suit :

Sub Test (ByRef A, ByRef B)
  B = B & " = " & A : A = 10*A
End Sub

Alors les variables X et Y de la procédure principale sont référencées directement par la sous-routine. Il en résulte que les valeurs de X et Y sont modifiées par la sous-routine, de sorte qu’après l’exécution de Test ; X = 450 et Y = "Number = 45". Il s’agit du comportement par défaut lorsque la méthode n’est pas explicitement déclarée.

Si, en revanche, la sous-routine est définie comme suit :

Sub Test (ByVal A, ByVal B)
B = B & " = " & A : A = 10*A
End Sub

Alors, après l’exécution de Test, la procédure principale indique ; X = 45 et Y = "Number" — c’est-à-dire qu’elles restent inchangées.

Autrement, si la sous-routine est définie comme suit (méthodes mixtes) :

Sub Test (ByRef A, ByVal B)
  B = B & " = " & A : A = 10*A
End Sub

Alors, après l’exécution de Test, X = 450 et Y = "Number", puisque Y a été passé par valeur, il reste inchangé.

Vous pouvez remplacer le paramétrage ByRef d’une fonction ou d’une sous-routine en plaçant des parenthèses autour d’un nom de variable dans l’instruction d’appel.

Appeler Test avec l’instruction suivante :

Test (X), Y

...transmettrait la variable X par valeur, quelle que soit la méthode définie pour ce paramètre dans la définition de la procédure.

Routines de date et d’heure

Le langage VBScript prend en charge un ensemble de routines de date/heure comme indiqué ci-dessous :

Routines d’E/S de fichier

Le langage VBScript prend en charge l’ensemble suivant de routines d’E/S de fichier :

Routines mathématiques

Le langage VBScript prend en charge l’ensemble suivant de routines mathématiques :

Routines de chaînes

Le langage VBScript prend en charge une gamme de routines de chaînes comme indiqué ci-dessous :

Routines de processus serveur

Les routines de processus serveur sont utilisées lors du traitement des processus dans les scripts, en particulier lorsqu’il est nécessaire d’extraire (obtenir) ou de définir des chaînes pour les paramètres du processus.

Pour exécuter des processus et des paramètres dans les scripts, utilisez les fonctions suivantes :

Useful functions

Useful Dialogs