Get req

Purpose: Obtain data that describes the input request.

 get-req \
         errno | error | cookie-count | cookie <cookie index> \
         | arg-count | arg-value <arg index> \
         | header <header> | referring-url | method \
         | content-type | trace-file | process-id | name \
     to <variable>

Copied!

Information related to an input request can be obtained with get-req statement and the result stored into <variable> (in "to" clause). The following can be obtained (all are strings except where stated otherwise):

"errno" obtains the integer value of operating system "errno" tied to a last Gliimly statement that can return a status code. The "errno" value is saved internally; and restored here. It means that if "errno" changed for whatever reason since such Gliimly statement (such as with call-extended), you will still obtain the correct value. See error-code for an example. Note that errno value is undefined if there is no error, and can be 0 if the error is reported by Gliimly and not by operating system.
"error" returns the error message that correlates to "errno" value.
"cookie-count" returns the number of cookies. This means any cookies received from the client plus any cookies added (with set-cookie) in the application minus any cookies deleted (with delete-cookie).
"cookie" returns the cookie value specified by <cookie index> (a sequential number starting with 1 up to the number of cookies), for instance:
```
 get-req cookie-count to cookie_c
 start-loop repeat cookie_c use i
     get-req cookie i to cookie_val
     pf-web "cookie %s\n", cookie_val
     @<br/>
 end-loop
```
Copied!
In this example, we get the number of cookies, and then print out each cookie value.
"arg-count" is the number of input arguments to your application (passed from a program caller, see "-a" option in mgrg and "--arg" in gg).
"arg-value" is the string value of a single element from the array of input arguments, specified by <arg_index>. This array is indexed from 1 to the value obtained by "arg-count". Here is an example of using arg-count and arg-value:
```
 get-req arg-count to ac
 pf-out "Total args [%ld]", ac
 start-loop repeat ac use i
     get-req arg-value i to av
     pf-out "%s\n", av
 end-loop
```
Copied!
This code will display the number of input arguments (as passed to main() function of your program, excluding the first argument which is the name of the program), and then all the arguments. If there are no arguments, then variable 'ac' would be 0.
"header" is the value of HTTP request header <header> that is set by the client. For example, if the HTTP request contains header "My-Header:30", then hval would be "30":
```
 get-req header "My-Header" to hval
```
Copied!
Note that not all HTTP request headers are set by the caller. For example, SERVER_NAME or QUERY_STRING are set by the web server, and to get such headers, use get-sys.
"method" is the request method. This is a number with values of GG_GET, GG_POST, GG_PUT, GG_PATCH or GG_DELETE for GET, POST, PUT, PATCH or DELETE requests, respectively. If it is not any of those commonly used ones, then the value is GG_OTHER and you can use get-sys with "environment" clause to obtain "REQUEST_METHOD" variable.
"content-type" is the request content type. It is a string and generally denotes the content type of a request-body, if included in the request. Common examples are "application/x-www-form-urlencoded", "multipart/form-data" or "application/json".
"referring-url" is the referring URL (i.e. the page from which this request was called, for example by clicking a link).
"trace-file" is the full path of the trace file for this request (if enabled, see trace-run).
"process-id" is the "PID" (process ID) number of the currently executing process, as a number.
"name" is the request name as specified in the request URL.

Examples

Get the name of current trace file:

 get-req trace-file to trace_file

Copied!