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;