Name(Value)elements. It provides a number of predefined elements for the result of parsing the first line of the request, followed by the additional request parameters. The predefined fields are:
- If the request contains
Host:Host, Host is unified with the host-name. If Host is of the format <host>:<port> Host only describes <host> and a field
port(Port)where Port is an integer is added.
- The Stream is passed along, allowing to read more data or requests from the same stream. This field is always present.
- Method is the HTTP method represented as a
lower-case atom (i.e.,
trace). This field is present if the header has been parsed successfully.
- Path associated to the request. This field is always present.
- Peer is a term
ip(A,B,C,D)containing the IP address of the contacting host.
- Port requested. See
- This is the untranslated string that follows the method in the request header. It is used to construct the path and search fields of the Request. It is provided because reconstructing this string from the path and search fields may yield a different value due to different usage of percent encoding.
- Search-specification of URI. This is the part after the
, normally used to transfer data from HTML forms that use the HTTP GET method. In the URL it consists of a www-form-encoded list of Name=Value pairs. This is mapped to a list of Prolog Name=Value terms with decoded names and values. This field is only present if the location contains a search-specification.
The URL specification does not demand the query part to be of the form name=value. If the field is syntactically incorrect, ListOfNameValue is bound the the empty list ().
- If the first line contains the
HTTP/Major.Minor version indicator this element indicate the HTTP version of the peer. Otherwise this field is not present.
- If the header contains a
Cookieline, the value of the cookie is broken down in Name=Value pairs, where the Name is the lowercase version of the cookie name as used for the HTTP fields.
- set_cookie(set_cookie(Name, Value, Options))
- If the header contains a
SetCookieline, the cookie field is broken down into the Name of the cookie, the Value and a list of Name=Value pairs for additional options such as
If the first line of the request is tagged with
reads all input upto the first blank line. This header consists of
Name:Value fields. Each such field appears as a
Name(Value) in the Request, where Name
is canonicalised for use with Prolog. Canonisation implies that the
Name is converted to lower case and all occurrences of the
are replaced by
_. The value
Content-length fields is translated into an integer.
end_of_fileif FdIn is at the end of input.