3.2.14 REMOVE

T.REMOVE(path) ! Str => Num

Remove the directory entry specified in 'path'. The exact format of 'path' depends on the operating system.

On systems supporting multiple links (names) for a single file, this procedure will only remove the specified link. On such systems, other links to the file may still be used to access the file. Only when the last link is removed, the file will become inaccessible. On other systems, REMOVE deletes the given file immediately.

REMOVE returns zero, if the directory entry could be deleted successfully and a negative value otherwise.

See also: RENAME, SYSTEM.OPENDIR