Added in 1.9.0


Searches the specified directory and its sub directories for the Nth directory name matching the wildcard specification and returns the full path and directory 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 directories, otherwise the Nth directory.
[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 sub directories found in $adiircdir.
//echo -ag $finddir($adiircdir,*.*,0)

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

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

Updated by Per Amundsen over 2 years ago · 6 revisions

Also available in: PDF HTML TXT