(LOGO.JPG) Python for OpenVMS

(go to: table of contents, index, list of vms_lib, prev: DELETE_LOGICAL, next: DIGIT_SEP)


DELETE_SYMBOL - Delete CLI Symbol


Format:
    vms_lib.delete_symbol (symbol [,table-type-indicator])
Returns:

None

Arguments:

symbol
Name of the symbol to be deleted.
table-type-indicator
1 = LIB$K_CLI_LOCAL_SYM - Local symbol table
2 = LIB$K_CLI_GLOBAL_SYM - Global symbol table

If omitted or None, the local symbol table is used.

Examples:
$ 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)

02-DEC-1998 ZE.