Click above to get retro games delivered to your door ever month!

cxCgiStr()
Returns the cooked form object data passed by the Web Server
---------------------------------------------------------------------

Syntax:

  cxCgiStr()  --->  cString

Arguments: None

Returns:

  A character string sent from the Web Server as a result of
  processing a form. This is the cooked or cleaned version of the string.

Description:

  cxCgiStr() should be considered as a debug function.
  Use cxCgiValue() or PubVars() to get form data for processing.

  The form-data is passed to the X-Hacker.orgprogram and is placed in a
  two-dimensional array.  This array is not directly accessible from
  a user program.  The data however is accessible in several ways.

  cxCgiStr() is one way to get the data.  Check the See-Also
  for additional form-variable retrieval functions.

  cxCgiStr() returns as a string, the cleaned query-string sent
   from the Web Server as a result of processing a form.

  Form data is sent to the CGI program in pairs of delimited values.
  cxCgiStr() presents this data as a character string with the following
  characteristics. Each pair of data consists of the name of the form object,
  an equal sign (=) and the value of the form object. Each of theses pairs
  of data is separated by an ampersand. Before the data is cleaned, it will
  also contain several escape sequence characters.

  The raw string from the web server may look like this:
      hiddenField=I%27m+hidding&eMailAddr=You+%26+I+say+1+%2B+1+%
      3D+2.&startMonth=01&startDay=01&startYear=94&endMonth=01&endDay=

  cxCgiStr() returns the cooked string:
      hiddenField=I'm hidding&eMailAddr=You & I say 1 + 1 = 2.

  This string may be useful for debugging purposes.

Examples:

  function Main()
    Local cQueryStr := ""
    if !ClipXOpen()            <-- The string is read from the Web Server here
      Quit
    endif
    header()

    cQueryString := cxCgiStr()  <-- Your copy of the string
    // or htmlWrite( cxCgiStr() )
    ...
    ...
    ...
  return nil

Files: Library is ClipX.Lib