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

nng_http_res_set_reason(3http)

NAME

nng_http_res_set_reason - set HTTP response reason

SYNOPSIS

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

int nng_http_res_set_reason(nng_http_res *res, const char *reason);

DESCRIPTION

The nng_http_res_set_reason() sets the human readable reason associated with the response res to reason.

If the value of reason is NULL (the default), then a default reason phrase is supplied based upon the value of the status code (see nng_http_res_set_status()).

The reason is never parsed automatically, but it can be a hint for humans to help them understand the nature of any erroneous result.

A local copy of the reason is made in the response res.

RETURN VALUES

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

ERRORS

NNG_ENOMEM

Insufficient memory to perform the operation.

NNG_ENOTSUP

No support for HTTP in the library.

SEE ALSO