◄Summary►  ◄Notes►  ◄Example►  ◄Back►
──────────────────────────────────────────────────────────────────────────────
 
▀ The function fails if:
  - any element of the pathname does not exist.
  - a directory with the same name at the end of the same path already
    exists.
  - the parent directory for the new directory is the root directory and
    is full.
  - [3.0+] the program is running on a network and the user running the
    program has insufficient access rights.
                                    -♦-