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 giv- ing the result of a request. The object returned only becomes valid once the request has been successfully dispatched (the return value of ne_re- quest_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 tar- get. 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 Loca- tion header was not present. EXAMPLES Display the response status code of applying the HEAD method to some re- source. 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)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLES | HISTORY | SEE ALSO | COPYRIGHT
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ne_get_status&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>