$findfile » History » Revision 4
Revision 3 (Per Amundsen, 08/12/2015 01:08 PM) → Revision 4/5 (Per Amundsen, 05/24/2018 10:11 AM)
_Added in 1.9.0_ *$findfile(dir,wildcard,N,[depth],[@window|command])* Searches the specified directory and its subdirectories for the Nth filename matching the [[Scripting_Wildcards|wildcard]] 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._ *Parameters* dir - The directory to search. wildcard - [[Scripting_Wildcards|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) *Properties* .shortfn - Return the path in a [[$shortfn|shortfn]] format. *Example* <pre> ; 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-) </pre>