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-Fileshel_write()
Shell Library
shel_find()                                                             AES

Syntax

WORD shel_find( buf )
char *buf;

Function       shel_find() searches for a file along the AES's current
               path, any paths specified by the 'PATH' environmental
               variable, and the calling application's path.

Opcode         124 (0x7C)

Availability   All AES versions.

Parameters     buf should point to a character buffer of at least 128
               characters and contain the filename of the file to search
               for on entry. If the function was able to find the file,
               the buffer pointed to by buf will be filled in with the
               full pathname of the file upon return.

Binding        addrin[0] = buf;

               return crys_if(0x7C);

Return Value   shel_find() returns 0 if the file was not found or non-zero
               otherwise.

See Also       shel_write()

Group          Shell Library