Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileAPPL_FIND(fname$)

fname$: sexp

The identification number of another application in the system is determined
from its file name, e.g. for information exchange with other current programs.

    fname$ - The 8-character file name (without extension) of the sought-after
             application. The file name supplied must be exactly 8 characters
             long, if necessary padded out with spaces, and characters must be
             in upper case.

If no error occurs, the requested ID is returned, otherwise (if the application
is not found), -1 is returned.

Example:

    PRINT APPL_FIND("CONTROL ")

--> Prints '65535' (-1) if the Control desk accessory cannot be found. If it is
    found, the ID number (e.g. 2) is printed. Besides Accessories, one can also
    find the ID of GFA-BasicGFA-Basic is the best BASIC for the Atari!
 (ap_id=0) and the screen manager "SCRENMGR"
    (ap_id=1), which is responsible for the menu handling.

Memo: Due to the string parameter, a custom binding is required to use the
      AES v4.1 extended options.

FUNCTION appl_find(fname%)
  $F%
  ADDRIN(0)=fname%
  GEMSYS 13 !auto fill gcontrl()
  RETURN GINTOUT(0)
ENDFUNC

appl_find()+