Difference between revisions of "Fs (API)"
From ComputerCraft Wiki
(Removed note about the a/b/c being the same as /a/b/c, since AFAIK that's not true unless your already at the root.) |
|||
| Line 49: | Line 49: | ||
If you need to deal with paths provided by the user that may be absolute or may be relative to the current working directory, use [[shell.resolve]]. | If you need to deal with paths provided by the user that may be absolute or may be relative to the current working directory, use [[shell.resolve]]. | ||
| − | |||
| − | |||
Revision as of 18:11, 9 June 2012
The FS API allows you to mess around with the filesystem.
Methods
| Method name | Description |
|---|---|
| fs.list(path) | Lists the directories and files in the given directory |
| fs.exists(path) | Checks if a path refers to an existing file or directory |
| fs.isDir(path) | Checks if a path refers to an existing directory |
| fs.isReadOnly(path) | Checks if a path is read-only (i.e. cannot be modified) |
| fs.getName(path) | Gets the final component of a pathname |
| fs.getDrive(path) | Gets the type of storage medium holding a file or directory |
| fs.makeDir(path) | Makes a directory |
| fs.move(fromPath, toPath) | Moves a file or directory to a new location |
| fs.copy(fromPath, toPath) | Copies a file or directory to a new location |
| fs.delete(path) | Deletes a file or directory |
| fs.combine(basePath, localPath) | Combines two path components, returning a path consisting of the local path nested inside the base path |
| fs.open(path, mode) | Opens a file so it can be read or written |
Path Names
All of these functions except for fs.combine refer solely to absolute paths.
This means that the current working directory, as set by the cd command or the shell.setDir function, is ignored. Each path name consists of a list of nonempty path components separated by forward slashes, and those path components are taken one by one with the first being contained in the root directory of the computer.
If you need to deal with paths provided by the user that may be absolute or may be relative to the current working directory, use shell.resolve.
