Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NE_GET_RESPONSE_HEAD(3)	      neon API reference       NE_GET_RESPONSE_HEAD(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_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);

SEE ALSO
       ne_request_create, ne_request_destroy.

AUTHOR
       Joe Orton <neon@lists.manyfish.co.uk>
	   Author.

COPYRIGHT
neon 0.30.2		       30 September 2016       NE_GET_RESPONSE_HEAD(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLES | SEE ALSO | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ne_get_response_header&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help