Subrutinas y funciones

Subrutinas y funciones de VBScript

Esta sección ofrece una visión general del uso de subrutinas y procedimientos en los scripts de Visual Basic de Altum Designer.

Pasar parámetros a procedimientos

Cuando se define en un script una función o subrutina (un procedimiento o método) que puede aceptar parámetros, las variables pueden pasarse a la función o subrutina de dos maneras: por referencia o por valor, utilizando ByRef o ByVal respectivamente.

Para declarar el método al que se pasan los parámetros, utiliza el ByRef o ByVal en la lista de parámetros al definir la función o subrutina en un Sub o Function . Por ejemplo, el siguiente fragmento de código define una subrutina que acepta dos parámetros. El primero se pasa por valor y el segundo por referencia:

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

La diferencia entre ambos métodos es que ByRef pasa una referencia a la variable y permite que la subrutina o función realice cambios en la variable real que se pasa como parámetro. Este es el método predeterminado para pasar parámetros y se utiliza si no se declara explícitamente otro método.

ByVal pasa únicamente el valor de la variable. La subrutina o función puede utilizar este valor, pero la variable original pasada no se modifica.

Los siguientes ejemplos ilustran las diferencias entre ambos métodos. El procedimiento principal es el siguiente:

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

El procedimiento anterior incluye una llamada a un subprocedimiento Test — véase más abajo.

Si la subrutina se define de la siguiente manera:

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

Entonces las variables X y Y en el procedimiento principal son referenciadas directamente por la subrutina. El resultado es que los valores de X y Y son modificados por la subrutina, de modo que, tras Test se ejecute, X = 450 e Y = «Número = 45». Este es el comportamiento por defecto cuando el método no se declara explícitamente.

Sin embargo, si la subrutina se define de la siguiente manera:

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

entonces, tras Test se ejecute, el procedimiento principal muestra: X = 45 e Y = «Número»; es decir, permanecen sin cambios.

Por otra parte, si la subrutina se define de la siguiente manera (métodos mixtos):

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

entonces, tras Test se ejecute, X = 450 e Y = «Number», ya que Y se pasó por valor, permanece sin cambios.

Se puede anular la ByRef configuración de una función o subrutina colocando paréntesis alrededor del nombre de una variable en la instrucción de llamada.

Al llamar a Test con la siguiente instrucción:

Test (X), Y

...pasaría la variable X por valor, independientemente del método definido para ese parámetro en la definición del procedimiento.

Rutinas de fecha y hora

El lenguaje VBScript admite un conjunto de rutinas de fecha y hora, tal y como se describe a continuación:

Rutinas de E/S de archivos

El lenguaje VBScript admite el siguiente conjunto de rutinas de E/S de archivos:

Rutinas matemáticas

El lenguaje VBScript admite el siguiente conjunto de rutinas matemáticas:

Rutinas de cadenas

El lenguaje VBScript admite una serie de rutinas de cadenas, tal y como se describe a continuación:

Rutinas de procesos del servidor

Las rutinas de procesos de servidor se utilizan al trabajar con procesos en scripts, especialmente cuando es necesario extraer (obtener) o establecer cadenas para los parámetros del proceso.

Para ejecutar procesos y parámetros en scripts, utiliza las siguientes funciones:

Useful functions

Useful Dialogs