This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. The latest released version is v1.8.0. See the documentation for v1.8.0 for the most up-to-date information.

nng_http_req_get_header(3http)

NAME

nng_http_req_get_header - return HTTP request header

SYNOPSIS

#include <nng/nng.h>
#include <nng/supplemental/http/http.h>

const char *nng_http_req_get_header(nng_http_req *req, const char *key);

DESCRIPTION

The nng_http_req_get_header() looks for an HTTP header key in the request req, and returns the associated value if found, or NULL if not found.

The value of key is case insensitive, and should not include the final colon in an HTTP header. For example, specifying Host or hOSt are equivalent, whereas the value Host: will not find anything.

RETURN VALUES

HTTP header value for key, if it exists, or NULL otherwise.

ERRORS

None.