www.LinuxHowtos.org

NE_GET_STATUS

Section: neon API reference (3)
Updated: 23 November 2024
Index Return to Main Contents

NAME

ne_get_status, ne_get_response_location - retrieve HTTP response properties

SYNOPSIS

#include <ne_request.h>

const ne_status *ne_get_status(const ne_request *request);
ne_uri *ne_get_response_location(ne_request *request);

DESCRIPTION

The ne_get_status function returns a pointer to the HTTP status object giving the result of a request. The object returned only becomes valid once the request has been successfully dispatched (the return value of ne_request_dispatch or ne_begin_request was zero).

If the response includes a Location header, the ne_get_response_location function parses and resolves the URI-reference relative to the request target. If a fragment ("#fragment") is applicable to the request target, it can be passed as an argument to allow appropriate relative resolution.

RETURN VALUE

ne_get_status returns a pointer to the HTTP status object giving the result of a request. This pointer is valid until the associated request object is destroyed.

ne_get_response_location returns a malloc-allocated ne_uri object, or NULL if either the URI in the Location header could not be parsed or the Location header was not present.

EXAMPLES

Display the response status code of applying the HEAD method to some resource.

ne_request *req = ne_request_create(sess, "HEAD", "/foo/bar");
if (ne_request_dispatch(req))
   /* handle errors... */
else
   printf("Response status code was %dn", ne_get_status(req)->code);
ne_request_destroy(req);

HISTORY

ne_get_response_location is available in neon 0.34.0 and later.

COPYRIGHT