HeaderValue (HttpResponse function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (match syntax table to syntax template; edits, tags and links)
 
Line 6: Line 6:
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%sting</th>
<tr><th>%string</th>
<td>A string or <var>[[Longstrings|longstring]]</var> variable for the assignment of the header value (or a zero-length string, if the requested header is not present).</td></tr>
<td>A string or <var>[[Longstrings|longstring]]</var> variable for the assignment of the header value (or a zero-length string, if the requested header is not present).</td></tr>
<tr><th>httpResponse</th>
<tr><th>httpResponse</th>
<td>A reference to an <var>[[HttpResponse_class|HttpResponse]]</var> object that was returned by a <var>[[Get_(HttpRequest_function)|Get]]</var>, <var>[[Post_(HttpRequest_function)|post]]</var>, or <var>[[Send_(HttpRequest_function)|Send]]</var> method of an <var>[[HttpRequest_class|HttpRequest]]</var> object.</td></tr>
<td>A reference to an <var>[[HttpResponse_class|HttpResponse]]</var> object that was returned by a <var>[[Get_(HttpRequest_function)|Get]]</var>, <var>[[Post_(HttpRequest_function)|Post]]</var>, or <var>[[Send_(HttpRequest_function)|Send]]</var> method of an <var>[[HttpRequest_class|HttpRequest]]</var> object.</td></tr>
<tr><th>name</th>
<tr><th>name</th>
<td>A string expression that yields the name of an HTTP response header. If <var class="term">name</var> is not present, <var>HeaderValue</var> returns a zero-length string.
<td>A string expression that yields the name of an HTTP response header. If <var class="term">name</var> is not present, <var>HeaderValue</var> returns a zero-length string.

Latest revision as of 19:41, 20 June 2011

HTTP response header value (HttpResponse class)

The HeaderValue 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

%string = httpResponse:HeaderValue( name, [occurrence])

Syntax terms

%string A string or longstring variable for the assignment of the header value (or a zero-length string, if the requested header is not present).
httpResponse 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.
occurrence 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).

If you specify a non-positive or non-numeric value, the request is cancelled. If occurence is not explicitly specified, its default is 1.

See also