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.3.2. See the documentation for v1.3.2 for the most up-to-date information.

nng_http_server_add_handler(3http)

NAME

nng_http_server_add_handler - add HTTP server handler

SYNOPSIS

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

int nng_http_server_add_handler(nng_http_server *s, nng_http_handler *h);

DESCRIPTION

The nng_http_server_add_handler() adds the handler h to the server instance s.

If another handler is already added to the server that would conflict with handler h, then the operation will fail with NNG_EADDRINUSE.

If a handler is added to a server, and the server is subsequently deallocated, the handler and any of its resources will also be deallocated.

Handlers that are added to a server may be subsequently removed using the nng_http_server_del_handler() function.

RETURN VALUES

This function returns 0 on success, and non-zero otherwise.

ERRORS

NNG_EADDRINUSE

Handler conflicts with another handler.

NNG_ENOMEM

Insufficient free memory exists.

NNG_ENOTSUP

HTTP not supported.

SEE ALSO