Finder

The procedures finder:get-file and finder:put-file query the user for a filename; finder:get-file gets the name of an existing file, and finder:put-file gets the name for a new file.

Under Windows and MacOS, finder:get-file and finder:put-file call finder:std-get-file and finder:std-put-file, which implement the filename query using platform-specific dialogs. Under Unix, finder:get-file and finder:put-file call finder:common-get-file and finder:common-put-file which use a platform-independent dialog. Which procedure finder:get-file and finder:put-file call depends on the value of the preference (see the preferences section) 'framework:file-dialogs. It it is 'common, the common platform-independent dialogs are used and if it is 'std, the standard platform-specific dialogs are used.

The finder:common-get-file and finder:common-put-file dialogs keep a separate directory state (for starting in the same place as the previous dialog ended); this directory can be obtained and set with the procedure finder:current-find-file-directory.

The procedure finder:common-get-file-list gets a list of filenames from the user using a platform-independent dialog. The arguments are the same as for finder:get-file and the result is either #f or a list of filenames.

All filenames returned by these procedures are normalized using normalize-path from mzlib's file utilities.

• Finder Utilities