445
GBL( ) Function
Reference Global String Variable
Formats
1. Get / Maintain Entries: GBL(string_name$[,contents$][,ERR=stmtref])
2. Delete / List Single Value: GBL({DELETE | LIST}string_name$[,ERR=stmtref])
3. Delete / List All up to Value: GBL({DELETE | LIST} TO string_name$[,ERR=stmtref])
4. Delete / List Table: GBL({DELETE | LIST} *[,ERR=stmtref])
Where:
*
Asterisk. Indicates all global string table entries.
contents$
Value to assign to the global string. Optional. String expression.
stmtref
Program line number or label to transfer control to.
string_name$ Name of the global string in the internal table. String expression.
Returns
Values in internal table of strings.
Note: This function is primarily provided for compatibility with other languages and
has been made virtually obsolete by global variables a much more efficient way to
handle common data elements (string, numeric, arrays, etc.).
Description
The GBL( ) function returns and maintains the values in an internal table of string
definitions.
Format 1: Get / Maintain Entries
GBL(string_name$[,contents$][,ERR=stmtref])
Use this format to set or obtain the current value of the global string variable whose
name you specify. If you include a contents value (optional) it will be placed into the
global string variable.
Format 2: Delete / List Single Value
GBL({DELETE | LIST}string_name$[,ERR=stmtref])
Use the GBL(DELETE ...) format to delete an individual global string from the table.
Use the GBL(LIST ...) format to have the function return an individual string.