AdiIRC

_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]] 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]] 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>