GET_HEADER_BY_NAME Procedure

This procedure returns the HTTP response header value returned in the response given the name of the header.

Syntax

UTL_HTTP.get_header_by_name(

r  IN OUT NOCOPY resp,
name  IN VARCHAR2,
value  OUT NOCOPY VARCHAR2,
n  IN PLS_INTEGER DEFAULT 1);

Parameters

Table 78-40 shows the parameters for the GET_HEADER_BY_NAME procedure.

Table 78-40 GET_HEADER_BY_NAME Procedure Parameters

Parameter	Description
r (IN/OUT)	The HTTP response
n (IN)	The nth occurrence of an HTTP response header by the specified name to return. The default is 1.
name (IN)	The name of the HTTP response header for which the value is to return
value (OUT)	The value of the HTTP response header.

Usage Notes

If the response body returned by the remote Web server is encoded in chunked transfer encoding format, the trailer headers that are returned at the end of the response body will be added to the response, and the response header count will be updated. You can retrieve the additional headers after the end of the response body is reached and before you end the response.