chickadee » chicken » process-context

Module (chicken process-context)

This module provides access to the current process context.

Information about the program's invocation

argc+argv

argc+argvprocedure

Returns two values: an integer and a foreign-pointer object representing the argc and argv arguments passed to the current process.

argv

argvprocedure

Return a list of all supplied command-line arguments. The first item in the list is a string containing the name of the executing program. The other items are the arguments passed to the application. It depends on the host-shell whether arguments are expanded ('globbed') or not.

command-line-arguments

command-line-argumentsparameter

Contains the list of arguments passed to this program, with the name of the program and any runtime options (all options starting with -:) removed.

executable-pathname

executable-pathnameprocedure

Returns a full pathname of the currently-running executable, or #f if it couldn't be determined. When evaluating code in the interpreter, this will be a path to csi.

program-name

program-nameparameter

The name of the currently executing program. This is equivalent to (car (argv)) for compiled programs or the filename following the -script option in interpreted scripts.

Access to environment variables

get-environment-variables

get-environment-variablesprocedure

Returns a association list of the environment variables and their current values (see also SRFI-98).

get-environment-variable

get-environment-variable STRINGprocedure

Returns the value of the environment variable STRING or #f if that variable is not defined. See also SRFI-98.

set-environment-variable!

set-environment-variable! VARIABLE VALUEprocedure

Sets the environment variable named VARIABLE to VALUE. Both arguments should be strings. If the variable is not defined in the environment, a new definition is created.

unset-environment-variable!

unset-environment-variable! VARIABLEprocedure

Removes the definition of the environment variable VARIABLE from the environment of the current process. If the variable is not defined, nothing happens.

Process filesystem context

change-directory

change-directory NAMEprocedure
(set! (current-directory) NAME)procedure

Changes the current working directory to NAME.

current-directory

current-directoryprocedure

Returns the name of the current working directory.


Previous: Module (chicken process signal)

Next: Module (chicken process-context posix)

Contents »