dmd.root.file

struct Buffer;

Owns a (rmem-managed) buffer.

pure nothrow @nogc @safe ubyte[] extractSlice();

Transfers ownership of the buffer to the caller.

struct File;

struct ReadResult;

pure nothrow @nogc @safe ubyte[] extractSlice();

Transfers ownership of the buffer to the caller.

pure nothrow @nogc ubyte[] extractDataZ();

ditto Include the null-terminator at the end of the buffer in the returned array.

static nothrow ReadResult read(const(char)[] name);

Read the full content of a file.

static nothrow bool write(const(char)* name, const void[] data);

static nothrow bool write(const(char)[] name, const void[] data);

Write a file, returning true on success.

static nothrow void remove(const(char)* name);

Delete a file.

static nothrow bool update(const(char)* namez, const void[] data);

static nothrow bool update(const(char)[] name, const void[] data);

Update file

If the file exists and is identical to what is to be written, merely update the timestamp on the file. Otherwise, write the file.

The idea is writes are much slower than reads, and build systems often wind up generating identical files.

Parameters:

const(char)[] name	name of file to update
void[] data	updated contents of file

Returns:

true on success

static nothrow ulong size(const char* namez);

Size of a file in bytes.

Parameters:

char* namez

null-terminated filename

Returns:

ulong.max on any error, the length otherwise.