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-FileSHEL_FIND(path$)

path$: svar

This function searches for a specified file and returns the full file
specification. Frist, the specified path on the current drive is searched, then
the root directory of the current drive, then the root directory of drive A:.

Returns 0 if the file name was not found, or 1 if it was.

On entry:
    path$ - String containing the sought-after file name.

On exit:
    path$ - Returns the full file specification if the file was found,
            otherwise it is unchanged.

Memo: A bug in the editor causes path$ to be +1 longer than it should be.
        A hidden trailing null is left on the end of the string.

shel_find()+