SYNOPSIS
#include <nng/nng.h>
#include <nng/supplemental/http/http.h>
int nng_http_handler_set_method(nng_http_handler *handler, const char *method);
DESCRIPTION
The nng_http_handler_set_method()
function sets the method that the
handler will be called for, such as "GET" or "POST". (By default the
"GET" method is handled.) If method is NULL
, then the request method
is not examined, and the handler will be executed regardless of the
method.
The server will automatically call "GET" handlers if the client sends a "HEAD" request, and will suppress HTTP body data in the responses sent for such requests. |
No validation of the method is performed, but HTTP specifications insist that the actual method sent over the wire be capitalized. |
The handler may always examine the actual method used using the nng_http_req_get_method(3) function.
RETURN VALUES
This function returns 0 on success, and non-zero otherwise.
ERRORS
NNG_ENOMEM
-
Insufficient free memory exists.
NNG_ENOTSUP
-
No support for HTTP in the library.