(go to: table of contents, index, list of vms_lib, prev: DELETE_LOGICAL, next: DIGIT_SEP)
None
Arguments:
If omitted or None, the local symbol table is used.
DELETE_SYMBOL - Delete CLI Symbol
Format:
02-DEC-1998 ZE.
vms_lib.delete_symbol (symbol [,table-type-indicator])
Returns:
Examples:
2 = LIB$K_CLI_GLOBAL_SYM - Global symbol table
$ VMS_LIB_SYM_DEFAULT = "VALUE_DEFAULT"
$ VMS_LIB_SYM_NONE = "VALUE_NONE"
$ VMS_LIB_SYM_GLOBAL == "VALUE_GLOBAL"
$ VMS_LIB_SYM_LOCAL = "VALUE_LOCAL"
>>> import vms_lib
>>> LIB_K_CLI_LOCAL_SYM = 1
>>> LIB_K_CLI_GLOBAL_SYM = 2
>>> vms_lib.delete_symbol ('VMS_LIB_SYM_GLOBAL', \
... LIB_K_CLI_GLOBAL_SYM)
>>> vms_lib.delete_symbol ('VMS_LIB_SYM_LOCAL', \
... LIB_K_CLI_LOCAL_SYM)
>>> vms_lib.delete_symbol ('VMS_LIB_SYM_NONE', None)
>>> vms_lib.delete_symbol ('VMS_LIB_SYM_DEFAULT')
$ show symbol VMS_LIB_SYM_*
%DCL-W-UNDSYM, undefined symbol - check validity and spelling
$
>>> # maximum length of symbol name is 255 characters
>>> symbol_name = 'S' * 256
>>> vms_lib.delete_symbol (symbol_name)
Traceback (innermost last):
File "<stdin>", line 1, in ?
vms_lib.error: (1409932, '%LIB-F-INVSYMNAM, invalid symbol name')
>>>
>>> symbol_name = 'S' * 65536
>>> vms_lib.delete_symbol (symbol_name)
Traceback (innermost last):
File "<stdin>", line 1, in ?
ValueError: argument 1: symbol - string size limited to 65535 characters
>>>
>>> vms_lib.delete_symbol ('SYMBOL', 3)
Traceback (innermost last):
File "<stdin>", line 1, in ?
vms_lib.error: (1409588, '%LIB-F-INVARG, invalid argument(s)')
>>>
>>> vms_lib.delete_symbol ('NON_EXIST_SYMBOL')
Traceback (innermost last):
File "<stdin>", line 1, in ?
vms_lib.error: (1409892, '%LIB-F-NOSUCHSYM, no such symbol')
>>>
>>> vms_lib.delete_symbol (1)
Traceback (innermost last):
File "<stdin>", line 1, in ?
TypeError: argument 1: expected read-only buffer, int found
>>> # that means 'string' ------^^^^^^^^^^^^^^^^
>>> vms_lib.delete_symbol ()
Traceback (innermost last):
File "<stdin>", line 1, in ?
TypeError: function requires at least 1 argument; 0 given
>>>
(go to: table of contents,
index,
list of vms_lib,
prev: DELETE_LOGICAL,
next: DIGIT_SEP)