Added in 1.9.0

$finddir(dir,wildcard,N,[depth],[@window|command])

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.

Parameters

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 or a command. (optional)

Properties

.shortfn - Return the path in a shortfn format.

Example

; Print number of sub directories found in $adiircdir.
//noop $finddir($adiircdir,*.*,0,echo -ag $1-)

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

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