LOOKUP%

Syntax LOOKUP% (search$)
Location Function (DIY Toolkit - Vol R)

This function expects you to pass a string parameter which contains a name used by the SuperBASIC interpreter. This name can be a machine code Procedure or Function (such as are described here in this manual), or a SuperBASIC variable, PROCedure or FuNction. If the specified name is recognised then LOOKUP% returns the number of its entry in the name list. If the name is not recognised, then the value -7 is returned.

Examples

PRINT LOOKUP% ('PRINT')

will return 0 on most QL ROMs as this is normally the first name in the name list.

PRINT LOOKUP% ('FSERVE')

can be used to see if Toolkit II’s fileserver is available.

NOTE 1

This function will only look at the name list for SuperBASIC Job 0, so although it can be used from within a compiled task to look at Job 0, it cannot be used to look at a multiple BASIC interpreter!!

NOTE 2

This function will only work correctly with machine code Procedures and Functions on SMS.

CROSS-REFERENCE

SeeELIS, KEY_ADD. _NAME$ allows you to look at the name list. See also FLIS and FIND.