1.44.3 Get methods

directory <-convert: name -> directory

Convert a name to the corresponding directory object. See directory->initialise for details.

See also

directory->initialise

directory <-files: pattern=[regex], hidden_too=[bool] -> names=chain

directory <-directories: pattern=[regex], hidden_too=[bool] -> names=chain

Returns a chain with the names of all member-directories or -files of this directory that match the regular expression name (see class regex). If pattern is omitted, all member-directories whose name does not start with a _._ are returned. If hidden_too is @on, directories with names starting _._ are considered too.

The names in the chain are alphabetically ordered.

See also

- directory->scan
- directory<-files

directory <-directory: name -> directory

directory <-file: name -> file

Return a file (or directory) object relative to the specified argument. If name starts with a’/’or’~’, these methods just return a new file or directory from name. Otherwise the new object will be created from directory<-path, and name, separated with a’/’.

directory <-file_name: name -> name

Create path relative to directory. If name denotes an absolute path it is returned unmodified. See also directory<-file, directory<-directory and directory<-parent.

directory <-parent: -> directory

Returns a new directory object that points to the parent directory. There are two ways to find such a directory. The first is to pwd on the entry _.._ and the second is to strip of the last part of the path by scanning for a’/’. XPCE uses the latter approach.

directory<-parent fails silently if the directory refers to the root of the file-system.

directory <-roots: -> chain

The method directory<-roots gathers the roots of the filesystem. On Unix, there is only one root, so a chain holding only’/’is returned. On windows, it returns the path-names of all defined logical drives. This call is used by library(find_file) to show all defined drives after an up from a drive-root.

The content of the directory object itself is not examined. For example (Windows):

?- get(directory('.'), roots, Roots),
   chain_list(Roots, List).

List = ['a:/', 'c:/', 'd:/', 'e:/', 's:/']