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

FreeBSD Manual Pages

  
 
  

home | help
NE_GET_STATUS(3)	      neon API reference	      NE_GET_STATUS(3)

NAME
       ne_get_status, ne_get_response_location - retrieve HTTP response
       properties

SYNOPSIS
       #include	<ne_request.h>

       const ne_status *ne_get_status(const ne_request *request);

       ne_uri *ne_get_response_location(ne_request *request);

DESCRIPTION
       The ne_get_status function returns a pointer to the HTTP	status object
       giving the result of a request. The object returned only	becomes	valid
       once the	request	has been successfully dispatched (the return value of
       ne_request_dispatch or ne_begin_request was zero).

       If the response includes	a Location header, the
       ne_get_response_location	function parses	and resolves the URI-reference
       relative	to the request target. If a fragment ("#fragment") is
       applicable to the request target, it can	be passed as an	argument to
       allow appropriate relative resolution.

RETURN VALUE
       ne_get_status returns a pointer to the HTTP status object giving	the
       result of a request. This pointer is valid until	the associated request
       object is destroyed.

       ne_get_response_location	returns	a malloc-allocated ne_uri object, or
       NULL if either the URI in the Location header could not be parsed or
       the Location header was not present.

EXAMPLES
       Display the response status code	of applying the	HEAD method to some
       resource.

	   ne_request *req = ne_request_create(sess, "HEAD", "/foo/bar");
	   if (ne_request_dispatch(req))
	      /* handle	errors... */
	   else
	      printf("Response status code was %d\n", ne_get_status(req)->code);
	   ne_request_destroy(req);

HISTORY
       ne_get_response_location	is available in	neon 0.34.0 and	later.

SEE ALSO
       ne_status, ne_request_create

COPYRIGHT
       Copyright (C) 2001-2024 Joe Orton

neon 0.34.0		       23 November 2024		      NE_GET_STATUS(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ne_get_response_location&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help