Function deleteFile [src]

Delete a file name and possibly the file it refers to, based on an open directory handle. On Windows, sub_path should be encoded as WTF-8. On WASI, sub_path should be encoded as valid UTF-8. On other platforms, sub_path is an opaque sequence of bytes with no particular encoding. Asserts that the path parameter has no null bytes.

Prototype

pub fn deleteFile(self: Dir, sub_path: []const u8) DeleteFileError!void

Parameters

self: Dirsub_path: []const u8

Possible Errors

AccessDenied UnlinkError

In WASI, this error may occur when the file descriptor does not hold the required rights to unlink a resource by path relative to it.

BadPathName UnlinkError

On Windows, file paths cannot contain these characters: '/', '*', '?', '"', '<', '>', '|'

FileBusy UnlinkError

FileNotFound UnlinkError

FileSystem UnlinkError

InvalidUtf8 UnlinkError

WASI-only; file paths must be valid UTF-8.

InvalidWtf8 UnlinkError

Windows-only; file paths provided by the user must be valid WTF-8. https://simonsapin.github.io/wtf-8/

IsDir UnlinkError

NameTooLong UnlinkError

NetworkNotFound UnlinkError

On Windows, \\server or \\server\share was not found.

NotDir UnlinkError

PermissionDenied UnlinkError

ReadOnlyFileSystem UnlinkError

SymLinkLoop UnlinkError

SystemResources UnlinkError

Unexpected UnexpectedError

The Operating System returned an undocumented error code.

This error is in theory not possible, but it would be better to handle this error than to invoke undefined behavior.

When this error code is observed, it usually means the Zig Standard Library needs a small patch to add the error code to the error set for the respective function.

Source

  pub fn deleteFile(self: Dir, sub_path: []const u8) DeleteFileError!void {
    if (native_os == .windows) {
        const sub_path_w = try windows.sliceToPrefixedFileW(self.fd, sub_path);
        return self.deleteFileW(sub_path_w.span());
    } else if (native_os == .wasi and !builtin.link_libc) {
        posix.unlinkat(self.fd, sub_path, 0) catch |err| switch (err) {
            error.DirNotEmpty => unreachable, // not passing AT.REMOVEDIR
            else => |e| return e,
        };
    } else {
        const sub_path_c = try posix.toPosixPath(sub_path);
        return self.deleteFileZ(&sub_path_c);
    }
}  