Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for ne_response_header_iterate (opensolaris section 3)

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 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_re-
       sponse_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\n", 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.

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)


All times are GMT -4. The time now is 03:27 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password