1.44.2 Send methods

directory ->access: {read,write}

Test if directory has access {read, write}. If a directory has write access, new files and directories can be created in this directory. See also directory->exists.

See also

- directory->exists
- file->access

directory ->cd:

Changes the working directory of the entire PCE/Prolog process to directory<-path.

See also

directory->push

directory ->exists:

Test if directory exists. A new directory can be created using directory->make. A typical sequence to ensure the existence of a directory is:

...
new(D, directory(Path)),
(   send(D, exists)
->  true
;   send(D, make)
),
...

See also directory->access.

See also

directory->access

directory ->initialise: path=name

Create a directory from the named path. A leading ~ or ~<user> is expanded as are shell variables notated as $<name>. directory<-path is filled with an absolute path to this directory, directory<-name with the basename of the directory.

See also

directory<-convert

directory ->make:

Create the OS counterpart (mkdir). See also directory->remove and directory->exists.

directory ->modified:

Succeed if directory has changed since last call to directory->modified. The first call just writes the current modification time in -modified and fails. If the directory does not exist any longer, directory->modified succeeds as well.

This method is intended for periodic changes to the set of members in a visualised directory. See also file<-time.

directory ->pop:

When @directory_stack is not empty this changes the working directory to the head of this chain and deletes the head of the chain. Used in combination with directory->push to temporary switch directories.

See also

directory->push

directory ->push:

Changes working directory like directory->cd. When successful, the old working directory is prepended to the chain @directory_stack as a name. The method directory->pop allows you to go back to the original directory.

See also

- directory->pop
- directory->cd

directory ->remove:

Delete the OS counterpart. This is equivalent to rmdir in both Unix and Windows. Note that removing a directory is only possible if it is empty. See also directory->make and directory->exists.

directory ->same: directory=directory

Test if two paths refer to the same physical directory. For details see file->same.

directory ->scan: files=chain*, directories=chain*, pattern=[regex], hidden_too=[bool]

Scans the directory appending all files matching regex to the first chain and all directories to the second. If the last argument is @on, files starting with a’.’are considered too.

If the same chain is given for files and directories, directory->scan will not determine the type. Depending on your Unix version, this may be much faster.

Bugs: Changes working directory while running. This will not be undone when execution is aborted while scanning the directory.

See also

- directory<-directories
- directory<-files