opensolaris man page for ne_get_response_header

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_response_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_response_header_iterate function can be used. This function takes a cursor param-
       eter  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 VALUE
       ne_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_header_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
", mtime);
	   }
       }
       ne_request_destroy(req);

SEE ALSO
       ne_request_create(3), ne_request_destroy(3).

AUTHOR
       Joe Orton <neon@webdav.org>.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWneon	      |
       +--------------------+-----------------+
       |Interface Stability | Volatile	      |
       +--------------------+-----------------+
NOTES
       Source for Neon is available on http://opensolaris.org.

neon 0.25.5							  20 January 2006					      NE_GET_RESPONSE_H(3)