QCGI.INC
й2001-2002 Chris Warrington
rapidq.basic.c45207@spamgourmet.com

Version: 1.3
Date: 09-DEC-2002

=====
Note ]
=====
a) Please turn "Word Wrap" OFF when viewing this file.
b) Please use a fixed-width font when viewing this file.

========
License ]
========
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

A copy of GNU General Public License can be found in the file gpl.txt,
included in the archive.

The GNU General Public License allows you to USE this library in any of your programs,
but you MUST release the source code. If you modify this library, those changes must also
be released. Be sure to see gpl.txt for the legal mumbo-jumbo.

====
Use ]
====
This file, unlike CGI_NEW.INC, is an object implementation of a CGI interface.

QCGI Properties
---------------
None

QCGI Methods
------------
The following functions return a CGI environmental variable in the form of a string:
GetCGIAccept
GetCGIAuthType
GetCGIContentLength*
GetCGIContentType
GetCGICookie
GetCGIGatewayInterface
GetCGIPathInfo
GetCGIPathTranslated
GetCGIReferer
GetCGIRemoteAddr
GetCGIRemoteHost
GetCGIRemoteIdent
GetCGIRemoteUser
GetCGIRequestMethod
GetCGIScriptName
GetCGIServerSoftware
GetCGIServerName
GetCGIServerPort
GetCGIServerProtocol
GetCGIUserAgent

* GetCGIContentLength returns an integer

Name | Type | Arguments | Description
===========|==========|=============================================|======================================
InitCgi | SUB | MaxInput AS INTEGER, AutoConvert AS INTEGER | Initializes the CGI object for use.
| | | See the section on constants for
| | | acceptable values for MaxInput and
| | | AutoConvert. This must be called!
-----------|----------|---------------------------------------------|--------------------------------------
GetValue | FUNCTION | Id$ AS STRING | Returns the value of Id$ as a string.
| | | If the Id$ is not found, an empty
| | | string is returned.
-----------|----------|---------------------------------------------|--------------------------------------
HexToAscii | FUNCTION | myInput$ AS STRING | Returns a string in which all %xx
| | | string have been converted into their
| | | ASCII equivalents. (When AutoConvert
| | | is cgiConvertAuto, it calls this.)

==========
Constants ]
==========

MaxInput Constants:
Name | Value
================|=======
cgiInputDefault | 32767
cgiInputLarge | 65535
cgiInputSmall | 255

AutoConvert Constants:
Name | Value
=================|===========
cgiConvertManual | 0 (false)
cgiConvertAuto | 1 (true)

========
Contact ]
========
If you find any bugs, need help, or have any suggestions, please e-mail me at
rapidq.basic.c45207@spamgourmet.com