RESETSPLPATH

Purpose:

Resets the SPL search path to the startup default.

Syntax:

RESETSPLPATH()

Returns:

A string, the new full SPL search path.

Example:

path = getmiscpath(1, 7) + "mypath";

mkdir(path);

copyfile("readme.txt", path + "\newreadme.txt");

addsplpath(path);

p1 = which("newreadme.txt", 0);

resetsplpath();

p2 = which("newreadme.txt", 0);

Creates a folder named mypath within the user Documents and Settings folder and copies the readme.txt file to the folder as newreadme.txt. The folder is added to the SPL search path.

WHICH locates newreadme.txt on the augmented search path and assigns the containing folder name to variable p1.

RESETSPLPATH removes the added custom path component. WHICH does not locate newreadme.txt and assigns an empty string to variable p2.

Remarks:

The SPL search path is searched for SPL functions, modules and user menus. RESETSPLPATH removes any added path components and resets the SPL search path to the startup default.