|
GBL( ) |
Reference Global String Variable |
|
1. |
GBL(string_name$[,contents$][,ERR=stmtref]) | |
|
2. |
GBL({DELETE | LIST}string_name$[,ERR=stmtref]) | |
|
3. |
GBL({DELETE | LIST} TO string_name$[,ERR=stmtref]) | |
|
4. |
GBL({DELETE | LIST}*[,ERR=stmtref]) |
|
* |
(Asterisk) Indicates all global string table entries. |
|
contents$ |
Value to assign to the global string. Optional. String expression. |
|
stmtref |
Program line number or statement label to which to transfer control. |
|
string_name$ |
Name of the global string in the internal table. String expression. |
Values in internal table of strings.
The GBL( ) function returns and maintains the values in an internal table of string definitions.
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.
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.
Delete/List All Up to Value
GBL({DELETE | LIST} TO string_name$[,ERR=stmtref])
Use the GBL(DELETE TO ...) format to delete items up TO an individual global string from the table.
Use the GBL(LIST TO ...) format to have the function return a list of global string names up TO an individual item ($00$ separated).
Delete/List Table
GBL({DELETE | LIST}*[,ERR=stmtref])
Use the GBL(DELETE *) format to remove all entries from the table.
The GBL(LIST *) format returns the names of all strings in the table ($00$ separated).