I/O library ("io")

This library contains the functions necessary to work with the file system (files and directories).

Functions:

• io_setcwd - set the current working directory
• io_getcwd - returns the current working directory
• io_getexecpath - returns the absolute executable path
• io_rename - rename or move a file system item
• io_file_exists - returns whether the specified file exists and is accessible
• io_dir_exists - returns whether the specified directory exists and is accessible
• io_stat - returns information about a file system item
• io_dir_create - create a directory
• io_dir_delete - remove a directory
• io_file_delete - deletes a file
• io_file_write - writes byte buffer to file, creating or overwriting it, as necessary
• io_file_read - reads byte buffer from a file
• io_file - creates a io_file object, optionally opening it
• io_dir - creates a io_dir directory iterator object, set to read a specific directory

Objects and their methods:

• io_file - file object
  • open - open a file
  • close - close the currently open file (if any)
  • read - read from the open file
  • write - write to the open file
  • seek - change read/write position in file
  • flush - flush the write buffer
  • setbuf - change the size and flush trigger of the write buffer or disables it
• io_dir - directory iterator object, for use in "foreach"

Constants:

• FILE_*** - mode constants for io_file.open / io_file [function]
• SEEK_*** - mode constants for io_file.seek
• FST_*** - file system item type constants for io_stat