Giff File and Directory IO - Owen2k6/GoOS GitHub Wiki

File & Directory I/O

All file paths are strings and may contain variables.

Note: Errors are caught and shown as a friendly dialogue, the script continues unless the operation is essential to subsequent logic.

File commands

fileWrite "path", "content"

Overwrites file with content (UTF-8).

fileAppend "path", "content"

Appends to file (UTF-8).

fileRead "path", varName

Reads entire file to varName (UTF-8). Missing file → error dialogue.

fileDelete "path"

Deletes file if it exists.

fileCopy "src", "dst"

Copies with overwrite.

fileExists "path", varName

Sets varName to "true" or "false".

Example:

set p = "0:\\notes.txt";
fileExists "$p", exists;
if "$exists == false" {
  fileWrite "$p", "Created by Giff\n";
} else {
  fileAppend "$p", "Appended at runtime\n";
}

Directory commands

dirCreate "path"

Ensures directory exists (like mkdir -p).

dirDelete "path"

Deletes directory recursively if it exists.

dirExists "path", varName

Sets varName to "true" or "false".

Example:

dirCreate "0:\\data\\logs";
dirExists "0:\\data", ok;
message "Data dir exists? $ok";
⚠️ **GitHub.com Fallback** ⚠️