Added in 1.9.0


Searches the specified directory and its subdirectories for the Nth filename matching the wildcard file specification and returns the full path and filename if it is found.

If /halt is used in the [command], the search is halted instead of the entire script.


dir - The directory to search.
wildcard - Wildcard to search for.
N - If N = 0, number of files, otherwise the Nth filename.
[depth] - Maximum folder depth. (optional)
[@window|command] - Custom window name to fill with the result or a command to run on each result. (optional)


.shortfn - Return the path in a shortfn format.


; Print number of filenames found in $adiircdir.
//echo -ag $findfile($adiircdir,*.*,0)

; Print the 1st filename found.
//echo -ag $findfile($adiircdir,*.*,1)

; Print all filenames in $adiircdir, when using the command parameter, $1- will hold the path.
//noop $findfile($adiircdir,*.*,0,echo -ag $1-)

Updated by Per Amundsen over 2 years ago · 3 revisions

Also available in: PDF HTML TXT