VBScript Reference Manual for InduSoft Web Studio

InduSoft Web Studio VBScript Reference Manual
Function
Description Declares the name, arguments, and code that form the body of a Function procedure
Usage [Public [Default] | Private] Function name [(arglist)]
[statements]
[name = expression]
[Exit Function]
[statements]
[name = expression]
End Function
Arguments Public
Indicates that the Function procedure is accessible to all other procedures in all scripts.
Default
Used only with the Public keyword in a Class block to indicate that the Function procedure
is the default method for the class. An error occurs if more than one Default procedure is
specified in a class.
Private
Indicates that the Function procedure is accessible only to other procedures in the script
where it is declared or if the function is a member of a class, and that the Function
procedure is accessible only to other procedures in that class.
name
Name of the Function; follows standard variable naming conventions.
arglist
List of variables representing arguments that are passed to the Function procedure when it
is called. Commas separate multiple variables.
The arglist argument has the following syntax and parts:
[ByVal | ByRef] varname[( )]
ByVal
Indicates that the argument is passed by value.
ByRef
Indicates that the argument is passed by reference.
varname
Name of the variable representing the argument; follows standard variable
naming conventions.
statements
Any group of statements to be executed within the body of the Function procedure.
expression
Return Value of the Function.
Remarks If not explicitly specified using either Public or Private, Function procedures are public by
default, that is, they are visible to all other procedures in your script. The value of local variables
in a Function is not preserved between calls to the procedure.
You cannot define a Function procedure inside any other procedure (e.g. Sub or Property Get).
The Exit Function statement causes an immediate exit from a Function procedure. Program
execution continues with the statement that follows the statement that called the Function
procedure. Any number of Exit Function statements can appear anywhere in a Function
procedure.
Like a Sub procedure, a Function procedure is a separate procedure that can take arguments,
perform a series of statements, and change the values of its arguments. However, unlike a Sub
procedure, you can use a Function procedure on the right side of an expression in the same way
you use any intrinsic function, such as Sqr, Cos, or Chr, when you want to use the value
returned by the function.
You call a Function procedure using the function name, followed by the argument list in
parentheses, in an expression. See the Call statement for specific information on how to call
Function procedures.
InduSoft, Ltd. 181