Method filesystem.enumDirectories

Overload

Gets names and other info of matching subdirectories in the specified directory.

public static IEnumerable<FEFile> enumDirectories(string directoryPath, string pattern = null, FEFlags flags = 0)
Parameters
directoryPath  (string)

Full path of the directory.
pattern  (string)

Directory name pattern. Format: wildcard expression. Can be null.
flags  (FEFlags)
Returns
IEnumerable<FEFile>

An enumerable collection of FEFile objects.
Exceptions
ArgumentException

directoryPath is invalid path or not full path. Invalid pattern ("**options " or regular expression).
DirectoryNotFoundException

directoryPath directory does not exist.
AuException

Failed to get children of directoryPath or of a subdirectory.

Remarks

Uses API FindFirstFile.

By default gets only direct children. Use flag FEFlags.AllDescendants to get all descendants.

The paths that this function gets are normalized, ie may not start with exact directoryPath string. Expanded environment variables (see pathname.expand), "..", DOS path etc. Paths longer than pathname.maxDirectoryPathLength have @"\\?\" prefix (see pathname.prefixLongPathIfNeed).

For NTFS links (symbolic links, mount points) gets link info, not target info.

These errors are ignored:

  1. Missing target directory of a NTFS link.
  2. If used flag FEFlags.IgnoreInaccessible - access denied.

When an error is ignored, the function works as if that [sub]directory is empty; does not throw exception and does not call errorHandler.

Enumeration of a subdirectory starts immediately after the subdirectory itself is retrieved.