NE_GET_RESPONSE_H(3) neon API reference NE_GET_RESPONSE_H(3)NAME
ne_get_response_header, ne_response_header_iterate - functions to
access response headers
SYNOPSIS
#include <ne_request.h>
const char *ne_get_response_header (ne_request *request,
const char *name);
void *ne_response_header_iterate (ne_request *request, void *cursor,
const char **name,
const char **value);
DESCRIPTION
To retrieve the value of a response header field, the ne_get_re‐
sponse_header function can be used, and is given the name of the header
to return.
To iterate over all the response headers returned, the ne_re‐
sponse_header_iterate function can be used. This function takes a cur‐
sor parameter which should be NULL to retrieve the first header. The
function stores the name and value of the next header header in the
name and value parameters, and returns a new cursor pointer which can
be passed to ne_response_header_iterate to retrieve the next header.
RETURN VALUEne_get_response_header returns a string, or NULL if no header with that
name was given. If used during request processing, the return value
pointer is valid only until the next call to ne_begin_request, or else,
until the request object is destroyed.
Likewise, the cursor, names, and values returned by ne_response_head‐
er_iterate are only valid until the next call to ne_begin_request or
until the request object is destroyed.
EXAMPLES
The following code will output the value of the Last-Modified header
for a resource:
ne_request *req = ne_request_create(sess, "GET", "/foo.txt");
if (ne_request_dispatch(req) == NE_OK) {
const char *mtime = ne_get_response_header(req, "Last-Modified");
if (mtime) {
printf("/foo.txt has last-modified value %s\n", mtime);
}
}
ne_request_destroy(req);
SEE ALSOne_request_create(3), ne_request_destroy(3).
AUTHOR
Joe Orton <neon@webdav.org>.
neon 0.25.5 20 January 2006 NE_GET_RESPONSE_H(3)