###User Defined Function###
_FO_FolderSearch

###Description###
Returns a list of the folders in the specified directory.

###Syntax###
#Include <FileOperations.au3>
_FO_FolderSearch ( $sPath[, $sMask = '*' [, $fInclude=True [, $iDepth=0 [, $iFull=1 [, $iArray=1 [, $sLocale=0]]]]]] )

###Parameters###
@@ParamTable@@
$sPath
	Search path
$sMask
	[optional] The mask containing the characters "*" and "?". The character "|" is used as a delimiter. The default is '*', which means the search all directories.
$fInclude
	[optional] Include or exclude the specified in a mask
		True - Find in accordance with mask (default)
		False - Find all except specified in a mask
$iDepth
	[optional] The depth of nesting of directories (0 - root directory; the default 125)
$iFull
	[optional] Paths in returned data
		0 - relative
		1 - (by default) Full path
$iArray
	[optional] Specifies the output: array or list
		0 - Delimited list @CRLF 
		1 - (by default) Array, where $iArray[0]=number of folders
		2 - Array, where $iArray[0] contains the first folder
$sLocale
	[optional] Case sensitivity.
		-1 - Not case sensitive (only for 'A-z').
		0 - (by default) Not case sensitive, by default. (for any characters)
		1 - Case sensitive (for any characters)
		&lt;&gt; - Not case sensitive, specified range of characters from local languages. For example '-'. 'A-z' is not required, they are enabled by default.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns a list of folders.
Failure:	Returns an empty string and sets @error:
@error:	1 - Invalid path
	2 - Invalid mask
	3 - Not found
@@End@@

###Remarks###
Be sure to check the @error, because in the absence of found directories, you cannot use an array. This results in an error that cannot be found in the test.

Use _FO_CorrectMask, to correct the errors that can be tolerated by the user when creating a mask.
In the GUI as a separator in the mask, you can use a different character, such as ";" or "," especially when using $iTypeMask=2, but in the function parameter to replace it with a "|". You can use the <font class="S41">Opt</font><font class="S81">(</font><font class="S71">"GUIDataSeparatorChar"</font><font class="S81">,</font> <font class="S41">Chr</font><font class="S81">(</font><font class="S31">1</font><font class="S81">))</font>, to set a separator for a Combo in the GUI.
Cannot create the directory depth of more than 125.

###Related###
_FO_CorrectMask, _FO_FileSearch

###Example###
@@IncludeExample@@