File System Functions

Variable absname (string path, string str)

Converts a relative filename and returns an absolute name. No attempt is made to create the shortest absolute name.

Arguments

• string path - Current path.
• string str - Relative path to be added.

Return value

Resulting path.

string basename (string path)

Returns a file name component of path. On Windows, both slash (/) and backslash (\) are used as directory separator character. In other environments, it is the forward slash (/).

Arguments

• string path - Full path.

Return value

File name.

int chdir (string name)

Changes the current directory to a new one.

Arguments

• string name - An absolute path to a new directory.

Return value

1 if the directory was changed; otherwise, 0.

string dirname (string path)

Returns directory name component of given path. On Windows, both slash (/) and backslash (\) are used as directory separator character. In other environments, it is the forward slash (/).

Arguments

• string path - Full path.

Return value

Directory name.

int get_mtime (string path)

Returns the time of the last modification of a given file or directory. To change the current time stamp, use the set_mtime() function.

Arguments

• string path - An absolute path to a file or a directory.

Return value

Time stamp of the last modification. If an error occurs, -1.

Examples

int is_dir (string path)

Checks if a given file system object exists and is actually a directory.

Arguments

• string path - An absolute path to a directory to check.

Return value

1 if the directory exists; otherwise, 0.

int is_file (string path)

Checks if a given file system object exists and is actually a file.

Arguments

• string path - An absolute path to a file to check.

Return value

1 if the file exists; otherwise, 0.

int mkdir (string pathname, int recursion)

Attempts to create a directory named pathname, optionally with subdirectories if a recursion flag is set (for example, a/b/c/d). By default, only one directory is created.

Arguments

• string pathname - An absolute path to the created directory.
• int recursion - This is an optional argument. 1 to create subdirectories; 0 to create one.

Return value

Return one on success, or zero if an error occurred.

string pathname (string path)

Resolves references to '/./', '/../' and extra '/' characters in the input path and return the canonical absolute pathname. The resulting path will have no '/./' or '/../' components.

Arguments

• string path - Input path.

Return value

Canonical pathname.

string relname (string path, string file)

Returns a relative path to a given file.

Arguments

• string path - A path to be used as a reference point.
• string file - A target file name.

Return value

Relative (to path location) path to the given file file.

int remove (string pathname)

Deletes a specified pathname from the filesystem.

Arguments

• string pathname - An absolute path name.

Return value

Return one on success, or zero if an error occurred.

int rename (string oldpath, string newpath)

Renames a file and moves it between directories, if required.

Arguments

• string oldpath - An old absolute path name.
• string newpath - A new absolute path name.

Return value

Return one on success, or zero if an error occurred.

int rmdir (string path, int recursion)

Attempts to remove a given directory, optionally with subdirectories if a recursion flag is set (for example, a/b/c/d). By default, only one directory is removed.

Arguments

• string path - An absolute path to the target directory.
• int recursion - This is an optional argument. 1 to remove subdirectories; 0 to remove one.

Return value

1 if the directory is removed successfully; otherwise, 0.

Variable set_mtime (string name, long time)

Sets the time of the last modification of a given file or directory. To get the current time stamp, use the get_mtime() function.

Arguments

• string name - An absolute path to a file or a directory.
• long time - Time stamp to set.

Return value

1 if the time stamp is set successfully; otherwise, 0.

Examples