Project

General

Profile

$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>