[Overview][Constants][Types][Procedures and functions][Index] Reference for unit 'BaseUnix' (#rtl)

FpUnlink

Unlink (i.e. remove) a file.

Declaration

Source position: bunxh.inc line 77

function FpUnlink(

  path: pChar

):cint;

function FpUnlink(

  const path: RawByteString

):cint;

Description

FpUnlink decreases the link count on file Path. Path can be of type AnsiString or PChar. If the link count is zero, the file is removed from the disk.

The function returns zero if the call was successful, a nonzero value indicates failure.

Note: There exist a portable alternative to erase files: system.erase. Please use fpUnlink only if you are writing Unix specific code. System.erase will work on all operating systems.

For an example, see FpLink.

Errors

Extended error information can be retrieved using fpGetErrno.

sys_eaccess
You have no write access right in the directory containing Path, or you have no search permission in one of the directory components of Path.
sys_eperm
The directory containing pathname has the sticky-bit set and the process's effective uid is neither the uid of the file to be deleted nor that of the directory containing it.
sys_enoent
A component of the path doesn't exist.
sys_enotdir
A directory component of the path is not a directory.
sys_eisdir
Path refers to a directory.
sys_enomem
Insufficient kernel memory.
sys_erofs
Path is on a read-only file system.

See also

FpLink

  

Create a hard link to a file

FpSymLink

  

Create a symbolic link


Documentation generated on: May 14 2021