GWBASIC User's Manual

GW-BASIC User's Guide
ENVIRON$ Function
Purpose:
To allow the user to retrieve the specified environment string from the environment table.
Syntax:
v$=ENVIRON$(parmid)
v$=ENVIRON$(nthparm)
Comments:
parmid is a valid string expression containing the parameter to search for.
nthparm is an integer expression in the range of 1 to 255.
If a string argument is used, ENVIRON$ returns a string containing the text following parmid=
from the environment string table.
If parmid is not found, then a null string is returned.
If a numeric argument is used, ENVIRON$ returns a string containing the nth parameter from the
environment string table.
If there is no nth parameter, then a null string is returned.
The ENVIRON$ function distinguishes between upper- and lowercase.
Examples:
The following lines:
ENVIRON "PATH=A:\SALES; A:\ACOUNTING; B:\MKT:" 'Create entry
PRINT ENVIRON$("PATH") 'Print entry
will print the following string:
A:\SALES; A:\ACCOUNTING; B:\MKT
The following line will print the first string in the environment:
PRINT ENVIRON$(1)
The following program saves the environment string table in an array so that it can be modified
for a child process. After the child process completes, the environment is restored.
10 DIM ENVTBL$(10)
20 NPARMS= 1
30 WHILE LEN(ENVIRON$(NPARMS))>0
file:///C|/Documents%20and%20Settings/Lorenzo/Desktop/GW%20Basic/ENVIRONS.html (1 of 2)28/03/2004 21.29.24