filepath Reference

Manage and report on the Max search path

filepath

Description

Provides access to the Max search path, and allows modification to the search path used by a patch.

Examples

Use filepath to check your search path or temporarily set search path slots for a patch

Discussion

The filepath object is used in the File Preferences patcher to report and change the various folders Max uses to look for files at certain times. It can assist with managing search paths in the File Preferences patcher or manage paths specific to a single patch.

Arguments

path-type [symbol]

Specifies one of the Max search path types (search, startup, help, action, or default)

preference [int]

Optional

A number greater than zero specifies a slot in the Preferences file. If the argument is 0 or no number is supplied, the path will not be saved in the Preferences file.

Attributes

Common Box Attributes

Messages

bang

bang causes the currently saved path name(s) to be output as a list.

append

Arguments

folder [list]
subfolder-flag [int]
The word append, followed by a symbol which specifies a folder, adds the folder to the list of paths (but does not save it in the Preferences file). An optional integer subfolder flag will also add any subfolders when set to 1.

clear

Arguments

input [int]
This method is obsolete. Currently, it has no effect.

revert

Causes the pathnames to be reset to the last set of Max file preferences to be saved.

set

Arguments

pathtype [list]
subfolder-flag [int]
The word set, followed by the name of a Max search path type (search, startup, help, action, or default), sets the current search path to the type specified. An optional integer subfolder flag will also add any subfolders when set to 1.

Output

symbol

The currently stored path name in response to a bang.

See Also

Name Description
Search Paths Search Paths
conformpath
filedate
folder
opendialog