DADiSP Worksheet Functions > Function Categories > Query Functions > GETMISCPATH

 

GETMISCPATH

Purpose:

Returns the path to a system directory.

Syntax:

GETMISCPATH(addpath, dirtype)

addpath

-

Optional. An integer, if 1, append the path separator character. Defaults to 1.

dirtype

-

Optional. An integer, the path type.

0:

current unique temp directory for temporary manipulation of DWK files (default)

1:

system defined temp directory with read/write privileges (e.g. \Documents and Settings\username\Local Settings\temp)

2:

main Windows directory (e.g. windows or winnt)

3:

Windows system directory (e.g. \windows\system32 or \winnt\system)

4:

DADiSP application data directory (e.g. \Documents and Settings\username\Application Data\DADiSP)

5:

generic application data directory (e.g. \Documents and Settings\username\Application Data)

6:

DADiSP document directory (e.g. \Documents and Settings\username\My Documents\DADiSP)

7:

generic document directory (e.g. \Documents and Settings\username\My Documents)

8:

user installation directory, the client directory for a network license, otherwise the same as GETHOME for all other licenses (e.g. \Program Files\DADiSP)

9:

Common DADiSP application data directory (e.g. \Documents and Settings\All Users\Application Data\DADiSP)

Returns:

A string.

Example:

getmiscpath

 

Returns the current temporary path (with appended path separator) for miscellaneous DWK files.

Example:

getmiscpath(0, 1)

 

Returns a system wide temporary directory.

Example:

getmiscpath(1, 3)

 

Returns the path to the Windows system files including an appended path separator.

Remarks:

GETMISCPATH is the directory where miscellaneous files can be placed to be add or extract from a DWK file. DADiSP automatically searches this directory for menus, macros and SPL functions.

 

GETMISCPATH((0, 1) returns a system directory where temporary files may be placed.

 

GETMISPATH(0, 8) returns the startup directory on the client machine for a network version of DADiSP and the location of the DADiSP executable for all other versions (same as GETHOME).

 

For a path that includes the username folder, username resolves to the login name of the current user.

See Also:

AUTOCONFIG

GETEXENAME

GETHOME

GETLABNAME

GETLABPATH

GETSPLPATH

GETWORKSHEETNAME