CL_path

Description

• Looks for files in directories and returns their paths.

  names can be a file name or a string containing wildcards ("*").

  If directories is omitted or is a blank string, %CL_PATH is searched if it is defined. If %CL_PATH does not exist, the working directory is searched.

  There are 2 possible search options:

  opt = "std": Returns the path of the first file found (sub-directories are not searched).

  opt = "all": Returns the paths of all the files found (sub-directories at any depth are searched. In this case, the search is "breadth-first".

  If no file is found, the returned value is []. An error is raised if err == %t and opt == "std".

  If hid is %t, hidden directories (whose name begin with ".") are searched, otherwise they're not, even if they belong to the "directories" list.

  If a directory name (in "directories") end with "/*", its name is replaced by the list of all its sub-directories.

Parameters

names:

(string) Name(s) of file(s) to be looked for (may contain wildcards). (1xN)

directories:

(string, optional) Directories to be searched. Default is "" (meaning: %CL_PATH if exists, '.' otherwise) (1xP)

opt:

(string, optional) Search option: "std" or "all". Default is "std" (1x1)

err:

(boolean, optional) %t is an error is raised if no file is found. Default is %t (1x1)

hid:

(boolean, optional) %t if hidden directories are included in the search. Default is %f (1x1)

paths:

(string) File path(s) or [] if no file is found (1xQ)

Authors

• CNES - DCT/SB

Examples

// Looks for "readme.txt" in CL_home() (sub-directories not searched) CL_path("readme.txt", CL_home()) // Returns all "*.scd" file (deep search) CL_path("*.scd", CL_home(), "all")