file_open

file_open :: (
    name: string,
    for_writing := false,
    keep_existing_content := false,
    log_errors := false
) -> (File, bool)

• By default it opens an existing file for reading; a missing file is a failure.
• for_writing opens for writing and creates the file when missing; an existing one is cut to nothing, unless keep_existing_content is set, which keeps its bytes and starts at the first one (it does not append: use file_seek(file, 0, .END) first). Without for_writing that flag does nothing.

name is UTF-8 and is converted to UTF-16 for the system; text that is not valid UTF-8, an empty name, and a name with a NUL byte are refused. / and \ both separate directories. Other programs may open, write and delete the file while it is open. A failure is logged as an error through context.logger only when log_errors is true.

Parameters

name: string

for_writing := false

keep_existing_content := false

log_errors := false

Returns

File

bool