Next Previous Up Top Contents Index

9.4 The OPERATING-SYSTEM module

environment-variable-setter

Function

Summary

Sets the value of an environment variable.

Signature

environment-variable-setter new-value name => new-value

Arguments

new-value
An instance of <byte-string>, or #f.

name
An instance of <byte-string>.

Values

new-value
An instance of <byte-string>, or #f.

Library

system

Module

operating-system

Description

Changes the value of the environment variable specified by name to new-value. If new-value is #f, the environment variable is undefined. If the environment variable does not already exist, environment-variable-setter creates it.

Note: Windows 95 places restrictions on the number of environment variables allowed, based on the total length of the names and values of the existing environment variables. The function environment-variable-setter only creates a new environment variable if it is possible within these restrictions. See the relevant Windows 95 documentation for more details.

See also

environment-variable, page 184


System and I/O Reference - 31 MAR 2000

Next Previous Up Top Contents Index