ne_get_status
3
ne_get_status
ne_get_response_location
retrieve HTTP response properties
#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 %d\n", ne_get_status(req)->code);
ne_request_destroy(req);
History
ne_get_response_location is
available in &neon; 0.34.0 and later.
See also
,