$findfile » History » Revision 3
Revision 2 (Per Amundsen, 08/12/2015 12:48 PM) → Revision 3/5 (Per Amundsen, 08/12/2015 01:08 PM)
_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 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 - 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>