basic.%unlink C Function/BASIC Program

basic.%unlink

Command basic.%unlink C Function/BASIC Program
Applicable release versions: AP/Unix
Category BASIC Program (486)
Description removes the directory entry named by the path name pointed to by "path". The named file is unlinked, and when all the links have been removed, and the file is no longer open, the file is removed.

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and system(0) is set to the value of errno.
Syntax code=%unlink( path )
Options
Example
include dm,bp,unix.h fcntl.h

* Get a unique temporary file name
fn='/tmp':system(19)
fd=%creat( fn, O$RDWR )
...

* Remove the temporary file
if %unlink( fn ) # 0 then
  crt 'Cannot remove temporary file. Error ':system(0)
end
Purpose
Related basic.cfunc
basic.%close
basic.%creat
basic.%open