(PYVMS LOGO) Python on OpenVMS

(go to: table of contents, index, list of vms_lib, prev: GET_MAXIMUM_DATE_LENGTH, next: GET_USERS_LANGUAGE)


GET_SYMBOL - Get Value of CLI Symbol


Format:
    resultant_string, table_type = vms_lib.get_symbol (symbol)
Returns:
resultant_string
contents of 'symbol'
table-type-indicator
1 = LIB$K_CLI_LOCAL_SYM - Local symbol table
2 = LIB$K_CLI_GLOBAL_SYM - Global symbol table
Arguments:
symbol
name of the symbol
Examples:
$ SYM_LOCAL  =  "LOCAL_SYMBOL"
$ SYM_GLOBAL == "GLOBAL_SYMBOL"

>>> import vms_lib

>>> LIB_K_CLI_LOCAL_SYM  = 1
>>> LIB_K_CLI_GLOBAL_SYM = 2

>>> print vms_lib.get_symbol ('$STATUS')
('%X00000001', 2)
>>>

>>> symbol, table = vms_lib.get_symbol ('$STATUS')
>>> print symbol, '-', table
%X00000001 - 2
>>>

>>> t = vms_lib.get_symbol ('$STATUS')
>>> t
('%X00000001', 2)
>>> type(t)
<type 'tuple'>

>>> print vms_lib.get_symbol ('$STATUS')[0]
%X00000001
>>>

>>> vms_lib.get_symbol ('SYM_LOCAL')
('LOCAL_SYMBOL', 1)
>>> vms_lib.get_symbol ('SYM_GLOBAL')
('GLOBAL_SYMBOL', 2)
>>>

>>> symbol = 'S'
>>> vms_lib.get_symbol (symbol)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_lib.error: (1409892, '%LIB-F-NOSUCHSYM, no such symbol')
>>>

>>> symbol = 'S' * 257
>>> vms_lib.get_symbol (symbol)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_lib.error: (1409932, '%LIB-F-INVSYMNAM, invalid symbol name')
>>>

>>> symbol = 'S' * 65536
>>> vms_lib.get_symbol (symbol)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
ValueError: argument 1: symbol - string size limited to\
 65535 characters
>>>

>>> vms_lib.get_symbol ()
Traceback (innermost last):
  File "<stdin>", line 1, in ?
TypeError: function requires exactly 1 argument; 0 given

>>> vms_lib.get_symbol (1)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
TypeError: argument 1: expected read-only buffer, int found
>>> # that means 'string' ------!!!!!!!!!

>>> vms_lib.get_symbol (None)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
TypeError: argument 1: expected read-only buffer, None found
>>>

(go to: table of contents, index, list of vms_lib, prev: GET_MAXIMUM_DATE_LENGTH, next: GET_USERS_LANGUAGE)

20-DEC-1998 ZE.