HeaderValue (HttpResponse function)
<section begin=dpl_desc/><section end=dpl_desc/>
HeaderValue is a member of the HttpResponse class.
This method helps you retrieve the HTTP response headers returned by an HTTP request. HeaderValue returns the value of the header whose name you specify, and it can optionally return the value of a particular occurrence of a header.
Syntax
%st = %httpresp:HeaderValue(name, [sub])
Syntax terms
| %st | A string or longstring variable for the assignment of the header value (or a zero-length string, if the requested header is not present). |
|---|---|
| %httpresp | A reference to an HTTPResponse object that was returned by a Get, Post, or Send method of an HTTPRequest object. |
| name | A string expression that yields the name of an HTTP response header. If name is not present, HeaderValue returns a zero-length string. |
| sub | Identifies a particular occurrence of header name. It is a numeric expression that must evaluate to an integer from 1 through the number of occurrences of the header. The number of occurrences is available from HeaderCount(name), as described in HeaderCount.
If you specify a non-positive or non-numeric value, the request is cancelled. If sub is not explicitly specified, its default is 1. |