restReqPostKey (Function)

This function will read the name of a post parameter in a request.

By calling this multiple times with incrementing index, it is possible to list all the post parameters in the request.

Note: Transferring files as post parameters is not currently supported.

Input:

req : SYSHANDLE

A handle to the request.

idx : INT (Default 0)

The index of the post parameter to read the name of.

Output:

name : STRING

The name of the parameter.

Returns: INT

Declaration:

FUNCTION restReqPostKey : INT;
VAR_INPUT
  req            : SYSHANDLE;
  idx            : INT;
  name           : ACCESS STRING;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM example;
VAR
  rc        : INT;
  str, name : STRING;
  i         : INT;
  req       : SYSHANDLE;
END_VAR
BEGIN
  ...
 
  i:=0;
  // Get name of post parameter
  rc := restReqPostKey(req:=req, idx:=i, name:=name);
  WHILE rc > 0 DO
    // Get value of post parameter
    restReqPostGet(req:=req, name:=name, value:=str);
    DebugMsg(message:=" "+name+"="+str);
    i:=i+1;
    // Get name of next post parameter
    rc := restReqPostKey(req:=req, idx:=i, name:=name);
  END_WHILE;
  ...
END;
END_PROGRAM;