◄Summary►  ◄Notes►  ◄Example►  ◄Back►
──────────────────────────────────────────────────────────────────────────────
 
▀ The function fails if:
  - any element of the pathname does not exist.
  - a file with the new pathname already exists.
  - the current pathname specification contains a different disk drive
    than does the new pathname.
  - the file is being moved to the root directory and the root directory
    is full.
  - [3.0+] the program is running on a network and the user has insuffi-
    cient access rights to either the existing file or the new directory.
 
▀ The * and ? wildcard characters are not allowed in either the current
  or new pathname specifications.
                                    -♦-