[ Operating System | Reference Manual | Alphabetic Index ]
pathname(+FilePath, -Path, -Name)
If FilePath is a pathname of a file, succeed if Path is the pathname of its
parent directory and Name is the local file name.
- FilePath
- String or atom.
- Path
- Variable or string.
- Name
- Variable or string.
Description
   This predicate is used to decompose FilePath which is either a relative
   or absolute pathname of a file, into two components, namely the pathname
   of its parent directory including the trailing "/" if any, and the plain
   name of the file Name.
Modes and Determinism
Exceptions
- (4) instantiation fault 
- FilePath is not instantiated.
- (5) type error 
- FilePath is neither a string nor an atom.
- (5) type error 
- Path is neither a string nor a variable.
- (5) type error 
- Name is neither a string nor a variable.
Examples
Success:
      [eclipse]: pathname("/home/user/userfile", P, F).
      P = "/home/user/"
      F = "userfile"
      yes.
      pathname("/home/user","/home/").
      pathname("/home/","/home/","").
      pathname("home","","home").
Fail:
      pathname("/home/file","/home","file").
Error:
      pathname(F,P,R).                 (Error 4).
      pathname("/home/file",P,file)    (Error 5).
See Also
pathname / 4