A class for reading and writing files. Not sound files.
Create a File instance and open the file. If the open fails, isOpen will return false.
A String containing the path name of the file to open.
a String indicating one of the following modes:
Same as *new, but a more intuitive name.
POSIX standard 'get current working directory'.
Open the file, evaluate the function with the file as argument, and close it again. If the process fails, close the file and throw an error.
Open the file at the given path, call -readAllString, and return the string. Whether the process succeeds or fails, the file will always be closed.
Open the file at the given path, call -readAllSignal, and return the signal. Whether the process succeeds or fails, the file will always be closed.
Open the file at the given path, call -readAllStringHTML, and return the string. Whether the process succeeds or fails, the file will always be closed.
Open the file at the given path, call -readAllStringRTF, and return the string. Whether the process succeeds or fails, the file will always be closed.
Answers if a file exists at that path.
Like *exists but ensure case sensitivity of the last path component on case insensitive filesystems. On case sensitive systems, it falls back to using
existsmethod, so use it only when really needed.
Answers if the filesystem is case sensitive or not.
Create directory at path, including any missing parent directories.
a Boolean, as follows:
true-- A new directory was created at
false-- A directory already existed at
path; a new one was not created.
Deletes the file at that path. Use only for good, never for evil.
a Boolean, as follows:
true-- You can assume that the path no longer exists. (Either it existed and was deleted, or it didn't exist and it still doesn't exist.)
false-- The file could not be deleted (probably a permissions error). Your code should assume that the path still exists.
Follow symbolic links (and aliases on macOS) and any parent directory references (like "..") and return the true absolute path.
a String or
nil if path did not exist.
Copy file, symlink or directory. this method will fail if pathNameTo already exists.
Symlinks are copied as symlinks (re-created).
Get file type as one of
\error, \not_found, \regular, \directory, \symlink, \block, \character, \fifo, \socket, \unknown
Get size of file in bytes.
Get last modification time in seconds since the Epoch.
If one of the above filesystem primitives fails, in most cases, a PrimitiveFailedError object will be thrown:
ERROR: Primitive '_FileMkDir' failed. caught exception 'boost::filesystem::create_directory: Permission denied: "/usr/oh-no-you-cant"' in primitive in method Meta_File:mkdir
Open the file. Files are automatically opened upon creation, so this call is only necessary if you are closing and opening the same file object repeatedly.
Close the file.
Reads the entire file as a String.
Reads the entire file as a String, stripping HTML tags.
Reads the entire file as a String, stripping RTF formatting.
Reads the entire file as a Signal, where every chunk of four bytes is interpreted as a 32-bit floating point sample.
Moves the read/write pointer to a given location in the file, where offset is location given in bytes, and origin is the reference of the offset:
Sets or returns the current position in the file (in bytes). when used as a setter, this method is a shortcut for seek(0, value). so setting the pos moves the current file position to a given location from the beginning of the file. the value is clipped so that it lies between 0 inclusively and the file length exclusively.
Returns the current file size in bytes.