Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Fileappl_write()
appl_init()
Application Services Library
appl_find()                                                             AES

Syntax

WORD appl_find( fname )
CHAR *fname;

Function       appl_find() searches the AES's current process list for
               a program named fname and, if present, returns the
               application identifier of the process.

Opcode         13 (0x0D)

Availability   All AES versions.

Parameters     fname is a pointer to a null-terminated ASCII string
               containing a valid GEMDOS filename (not including an
               extension) padded with blanks to be exactly 8 characters
               long (not including the NULL).

Binding        addrin[0] = fname;

               return crys_if(0x0D);

Return Value   appl_find() returns the application identifier of the
               process if it is found or -1 otherwise.

Version Notes  AES versions from 4.0 add several extensions to this call
               for the benefit of MultiTOS as follows: If the upper word
               of the CHAR * is 0xFFFF, the lower word is assumed to be
               the MiNT id and appl_find() will return the AES application
               identifier.
               If the upper word of the CHAR * is 0xFFFE, the lower word
               is assumed to be the AES application identifier and the
               MiNT id is returned.
               If the upper word of the CHAR * is 0x0000, the current
               processes' application identifier is returned. This
               functionality only exists if the AES version is 4.0 and
               above and appl_getinfo() indicates that it is available.

See Also       appl_write(), appl_init()

Group          Application Services Library