Advertisements
SET PATH
Specify the Clipper search path for opening files
------------------------------------------------------------------------------
Syntax
SET PATH TO [<xcPathspec list>]
Arguments
TO <xcPathspec list> identifies the paths Clipper uses when
searching for a file not found in the current directory. You can
specify it as a literal list or as a character expression enclosed in
parentheses. The list of paths can be separated by commas or
semicolons. However, continuation of a SET PATH command line with a
semicolon is not supported unless <xcPathspec> is specified as a
character expression enclosed in parentheses.
Description
SET PATH allows commands and functions that open database and associated
files to find and open existing files in another drive and/or directory.
It does this by specifying a path list to search if a referenced file
cannot be found in the DEFAULT or specified directory. Note that memo
and low-level file functions respect neither the DEFAULT nor the path
setting.
A path is a pointer to a directory. It consists of an optional drive
letter and colon, followed by a list of directories from the root to the
desired directory separated by backslash (\) characters. A path list is
the sequence of paths to search, each separated by a comma or semicolon.
When you attempt to access a file, Clipper first searches the default
drive and directory. The default disk drive and directory are
established by DOS when your Clipper application is loaded or, during
execution, by SET DEFAULT. If the file is not found, Clipper then
searches each path in the specified path list until the first occurrence
of the file is found.
To create new files in another drive or directory, use SET DEFAULT TO
<xcPathspec> or explicitly declare the path when specifying a new file
name.
SET PATH TO with no argument releases the path list and Clipper
searches only the DEFAULT directory.
Examples
. This example is a typical PATH command:
SET PATH TO A:\INVENTORY;B:\VENDORS
. This example configures a path setting at runtime by passing a
DOS environment variable to a program, retrieving its value with
GETENV(), and then setting path with this value. For example, in
DOS:
SET CLIP_PATH=C:\APPS\DATA,C:\APPS\PROGS
Later in the configuration section of your application program:
SET PATH TO (GETENV("CLIP_PATH"))
Files Library is CLIPPER.LIB.
See Also: CURDIR() SET DEFAULT
Advertisements