ProvideX V8.20 > Language Reference > 2. Directives
247
PREFIX Directive
          Set File Search Rules
Formats
1. Set Prefix 0: PREFIX [search_string$]
PREFIX (num)[search_string$]
2. Set Any Prefix Number:
PREFIX PROGRAM [search_string$]
3. Set Program Retrieval Rules:
4. Specify Search Rules in Keyed File: PREFIX FILE [filename$]
Where:
filename
Name of a variable-length Keyed file containing data records that
define the locations of specific files (in effect, a lookup or
translation table).
Numeric value between 0 and 9 which defines the PREFIX entry to
num
use. If you omit this value, the default is zero.
search_string$ One or more pathname prefixes (search locations) you want
ProvideX to search when attempting to find files / programs.
Optional string expression.
Use a null string, PREFIX [(num)]"", or omit the string, PREFIX
[(num)]) to have ProvideX reset your PREFIX to null.
When you have more than one search location in a PREFIX directive,
the different locations must be space-separated. If you need to
include a space within a directory name, then that directory location
must be enclosed in double quotation marks; e.g.,
PREFIX "C:\Tmp\ C:\Usr\ ""C:\Program Files\"""
Description
Use the PREFIX directive to define a series of search paths to be inserted in front of
all relative file references used in OPEN / LOAD / RUN / CALL / PERFORM
directives. (ProvideX opens files with absolute paths directly, without performing a
search.)
Each prefix can contain 0 zero or more search locations. (A search location is either a
directory or a disk/directory pair.) You can specify up to 10 differently-numbered
prefixes (i.e., PREFIX (0) through PREFIX (9)) as well as a PREFIX PROGRAM and
a PREFIX FILE. See the descriptions of the various formats, below.
See Also
ProvideX Search Rules, p.249,
Equal Signs for Matching, p.249,
Asterisks as PREFIX Wildcards, p.250,
[LIB] Tag, p.777
Using the PREFIX Directive in the ProvideX User's Guide.