Manual Pages for UNIX Operating System command usage for man ne_response_header_iterate

neon API reference                        NE_GET_RESPONSE_HEAD(3)



NAME
     ne_get_response_header, ne_response_header_iterate -
     functions to access response headers

SYNOPSIS
     #include 

     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

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_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\n", mtime);
             }
         }
         ne_request_destroy(req);



neon 0.29.0      Last change: 13 September 2009                 1






neon API reference                        NE_GET_RESPONSE_HEAD(3)



SEE ALSO
     ne_request_create, ne_request_destroy.

AUTHOR
     Joe Orton 
         Author.

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

     box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE =
     Availability   library/neon = 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       |  library/neon   |
    |____________________|__________________|_
    | Interface Stability|  Volatile       |
    |____________________|_________________|

NOTES
     Source for Neon is available on http://opensolaris.org.























neon 0.29.0      Last change: 13 September 2009                 2