| %TTYNAME | Index Level | %WAIT |
| Syntax | code = %UNLINK( path ) |
| Category | BASIC |
| Type | C Function |
| 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. |
| Options | |
| See Also | c function %CLOSE %CREAT %OPEN |
| 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 |
| Warnings | |
| Compatibility | D3/Unix |
| %TTYNAME | Index Level | %WAIT |