The [getStandardFolder] command.

Description

The getStandardFolder command returns the full path of certain directories linked to the system. Optionally, this function can create (or attempt to create, depending on the permissions) the folders when they do not already exist.

Synopsis

The syntax of the command is:
• getStandardFolder ?-create? name ?domain?
The arguments have the following signification:

the -create option tells to attempt to create the folder if it does not exist. This argument is optional.
name is a symbolic name designating a particular folder. For possible values, see the Symbolic folder names section below.
domain is optional. It specifies the domain the folder belongs to. For instance, there are several Fonts directories on the system, corresponding to different domains: /System/Library/Fonts in the System domain, /Library/Fonts in the local domain, or ~/Fonts in the user domain. Possible values for this parameter are: local, network, system, or user. If this argument is not specified, the default value is system.

Note that the directory returned by this command may not exist. This method simply gives the appropriate location for the requested directory. Furthermore, this command will not necessarily succeed and return a folder path, depending on the requested domain. If no folder path is found, the command raises an error.

Symbolic folder names

One must specify the folder using a symbolic name. The table below indicates the currently available names:

Name	Description
AdminApplications	System and network administration applications (Utilities)
Applications	Supported applications
ApplicationScripts	The user scripts folder for the calling application
ApplicationSupport	Application support files
AutosavedInformation	The user’s autosaved documents
Caches	Discardable cache files
CoreServices	Core services
DemoApplications	Unsupported applications and demonstration versions
Desktop	The user’s desktop directory
Developer	Developer resources
DeveloperApplications	Developer applications
Documents	Documents directory
Documentation	Documentation
Downloads	The user’s downloads directory
InputMethods	Input Methods
Library	Various user-visible documentation, support, and configuration files
Movies	The user’s Movies directory
Music	The user’s Music directory
Pictures	The user’s Pictures directory
PreferencePanes	The PreferencePanes directory for use with System Preferences
PrinterDescription	The system’s PPDs directory
SharedPublic	The user’s Public sharing directory
Trash	The trash directory
Users	User home directories (/Users)

Examples

Here are some examples to demonstrate the use of the [getStandardFolder] command. Open the Tcl Shell (with ⌘Y) and enter the following commands, one by one.
To get the user's Applications folder:

getStandardFolder AllApplications user

To get the local Applications folder:

getStandardFolder AllApplications local

To get the local Demos folder:

getStandardFolder DemoApplication local

To get the user's Demos folder and create it if does not exist:

getStandardFolder -create DemoApplication user

To get the system Users folder:

getStandardFolder User system

Last updated 2020-05-27 14:28:48