from small one page howto to huge articles all in one place
Last additions:
May 25th. 2007:
April, 26th. 2006:
|
You are here: manpages
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.
SEE ALSO
ne_status,
ne_request_create
COPYRIGHT
Copyright © 200-2024 Joe Orton
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- EXAMPLES
-
- HISTORY
-
- SEE ALSO
-
- COPYRIGHT
-
|