Filesystem: file.ss

See also section 11.2.

(build-absolute-path base path )

Like build-path (see section 11.2), but base is required to be an absolute pathname. If base is not an absolute pathname, error is called.

(build-relative-path base path )

Like build-path (see section 11.2), but base is required to be a relative pathname. If base is not a relative pathname, error is called.

Deletes the file or directory specified by path, raising exn:i/o:filesystem if the file or directory cannot be deleted. If path is a directory, then delete-directory/files is first applied to each file and directory in path before the directory is deleted. The return value is void.

Returns the list of directories that constitute path. The path argument must be normalized (except for letter case; see normalize-path below).

If path is a file pathname, returns just the file name part without the directory path.

Returns a string that is the extension part of the filename in path. If path is (syntactically) a directory, #f is returned.

Returns the path of the specified library (see Chapter 15), returning #f if the specified library or collection cannot be found. The collection argument is optional, defaulting to "mzlib".

Finds a relative pathname with respect to basepath that names the same file or directory as path. Both basepath and path must be normalized (except for letter case; see normalize-path below). If path is not a proper subpath of basepath (i.e., a subpath that is strictly longer), path is returned.

Creates directory specified by path, creating intermediate directories as necessary.

Creates a new temporary file and returns a pathname string for the file. Instead of merely generating a fresh file name, the file is actually created; this prevents other threads or processes from picking the same temporary name. However, the file is not opened for reading or writing when the pathname is returned. The client program calling make-temporary-file is expected to open the file with the desired access and flags (probably using the 'truncate flag; see section 11.1.5) and to delete it when it is no longer needed.

If format-string is specified, it must be a format string suitable for use with format and one additional string argument (where the string contains only digits). The default format-string is "mztmp~a".

Returns a normalized, complete version of path, expanding the path and resolving all soft links. If path is relative, then the pathname wrt is used as the base path. The wrt argument is optional; if is omitted, then the current directory is used as the base path.

Letter case is not normalized by normalize-path, so combine normalize-path with normal-case-path to get strings for path comparison.

An error is signaled by normalize-path if the input path contains an embedded path for a non-existent directory, or if an infinite cycle of soft-links is detected.

If path is a filename, the file's path is returned. If path is syntactically a directory, #f is returned.