gos.file.exists¶

Test for a regular file in an approved root; a missing file returns false without an error.

Signature¶

gos.file.exists(path)

Contract and usage¶

FileExist(path)¶

Alias: gos.file.exists(path).

Returns true for a regular file and false otherwise. A rejected path returns false, error; an ordinary missing file returns false without an error.

local exists, error = FileExist(CACHE_PATH .. "state.txt")

Root Constants¶

Each path ends with the platform directory separator:

SCRIPT_PATH
COMMON_PATH
SPRITE_PATH
FONTS_PATH
SOUNDS_PATH
CACHE_PATH

SCRIPT_PATH is the current entry script's directory; COMMON_PATH is the configured shared-module root. To find their actual values, run the status panel and open its Log tab. Open Folder opens the active-script directory. Shared modules need not be beside a portable entry script; use COMMON_PATH instead of guessing a path.

Relative file paths resolve from SCRIPT_PATH. File operations must stay inside the approved roots; network-share and device paths are rejected.

File Helpers¶

Global helpers and their gos.file aliases have identical arguments and results. An omitted error return becomes nil in a two-variable assignment.

Related documentation¶

Full modules and files contract