cgiGetEnv

function

Library: CGI programming support (OMCGI)
Include: omcgi.xin

Declaration
define function cgiGetEnv
  into write-only string env-shelf

Argument definitions

env-shelf
A string or stream shelf of variable size.


Purpose

The cgiGetEnv function retrieves the values of all CGI-related environment variables. The function places those values on a keyed string shelf of name/value pairs, where the key of the item is the name of the environment variable and the item's value is the value of that variable. Declare the shelf you want the variables placed on as variable. Note that the function always clears the shelf before placing values on it. For example:

     declare #process-input has unbuffered
     declare #process-output has binary-mode
     include "omcgi.xin"
  
     process
        local string env-vars variable
  
        cgiGetEnv into env-vars

The cgiGetEnv function retrieves the following list of CGI-related environment variables. Note that not all web servers will set all of these variable values in all situations. If the web server doesn't set the value of a variable, its value is a zero-length string.

Other Library Functions