Version: 5
restore

Contents

Method

FindDirectoryByName

ModuleFileSystem
LibraryCore
Action

Finds a folder by name.

Parameters

DirectoryName (string): The name of the sub-directory to be found. This cannot contain path separators and therefore is just the leaf node of the path (the deepest part of the path).

The name can include wildcard characters ? and *.

Fast ( boolean; optional, default true): chooses between the fast (and beta) search technology or the previous slower (but fully reliable) technology.

Case insensitive wildcards are supported only on Windows.

Android currently does not support wildcards, exact match is required


Return values

For each directory found:

    • Path (string): The full path of the directory.
Example
FileSystem.FindDirectoryByName(DirectoryName:"wibble", Fast:true);

The above method call might find the following on relevant platforms:

  • "c:\Program Files\Acme Corp\Wibble"
  • /usr/local/wibble

But it will never find these:

  • "c:\Program Files\Acme Corp\Wibble\bin"
  • /usr/local/wibble/bin
Platforms
  • Windows
  • Linux
  • MacOS
  • Solaris Intel
  • Solaris Sparc
  • Android
Notes

This will search all fixed disks which is a resource expensive process and may take some time if fast=false.