A-Shell Reference

Function

Description

.ARGTYP()

Returns the type of the specified argument passed to the current SBX, function, or procedure.

.ARGSIZ()

Returns the size of the specified argument passed to the current SBX, function, or procedure.

.ARGTYP_READONLY()

Indicates whether the specified argument is read-only.

.ARG_PASSED()

Indicates whether the specified argument was passed to the current SBX, function, or procedure.

ERR()

ERR() is used within an error trap to return information relating to a ASB error that has occurred, based on X.

ERRMSG()

ERRMSG(X) returns the message associated with ASB error X, based on contents of sys:errmsg.xxx. This is an A-Shell extension, requires COMPIL /X:2.

.EXTENT()

Returns the "extent" of the specified array or collection.

GETKEY()

This function inputs and returns the ASCII decimal value of a single character.

MEM()

MEM(X) returns information about available memory and resources. See table of MEM(X) Values below.

PYFUNC()

Provides a means to call an external function written in Python version 3.

XFUNC(), XFUNC$()

XFUNC and XFUNC$ execute an external SBX routine, returning a numeric or string value.

Function

Description

MEM(0)

returns the number of bytes of free space remaining in the "partition," which is used mostly for variable storage, expression evaluation, stack, and possibly SBX loading.

MEM(1)

returns total size of "partition." See MEMORY.LIT, MX_MEMORYXS, and MEMORYSP for further discussion and methods of configuring partition size.

MEM(5)

size of compiled object code area

MEM(6)

size of DATA pool

MEM(7)

size of array storage area

MEM(8)

size of variable storage area (excluding arrays)