LoadFileForMe

Syntax

native LoadFileForMe(const file[], buffer[], maxlength, &length = 0);

Usage

file
File to load (may be a file from the GCF)
buffer
Buffer to store file contents
maxlength
Maximum size of the file buffer
length
Variable to store the file length.  This may return
a number larger than the buffer size

Description

Loads a file using the LoadFileForMe engine function.

The data is truncated if there is not enough space.  No null-terminator
is applied; the data is the raw contents of the file.

Return

-1 if the file could not be loaded.  Otherwise,
the number of cells actually written to the buffer
are returned.