ne_xml_parse_response - Man Page

#include <ne_xmlreq.h>

int ne_xml_parse_response(ne_request *req, ne_xml_parser *parser);

int ne_xml_dispatch_request(ne_request *req, ne_xml_parser *parser);

int ne_xml_dispatchif_request(ne_request *req, ne_xml_parser *parser, ne_accept_response acceptor, void *userdata);

The ne_xml_parse_response function reads an HTTP response body and processes it using the given XML parser. The function must be called ne_begin_request has returned successfully for the request, and then invokes ne_read_response_block until the entire response body has been read. On successful return, ne_end_request must be called to finalise response processing.

The ne_xml_dispatch_request and ne_xml_dispatchif_request functions is equivalent to calling ne_request_dispatch to dispatch an HTTP request and process the response, parsing the response body using the given XML parser under certain conditions:

• For ne_xml_dispatch_request, any 2xx class response with an XML content-type.
• For ne_xml_dispatchif_request, if the acceptor callback returns non-zero, and the response uses an XML content-type.

In both cases, the rules in RFC 7303^[1] are followed to identify XML content-types, that is text/xml, application/xml, or any other content-type ending in a +xml suffix. The userdata parameter is passed to the acceptor function.

For all three functions:

• the XML parser is invoked repeatedly until the end of the document is reached.
• if an error occurs during XML parsing, the session error string is set to describe the parse error, and the connection is terminated without continuing to process the response..

All functions documented here return zero on success, or an NE_* error code on failure.

ne_xml_dispatchif_request is available in neon 0.36.0 and later.

ne_xml_create, ne_request_dispatch

Copyright © 2001-2025 Joe Orton

1.

RFC 7303
https://www.rfc-editor.org/rfc/rfc7303

The man pages ne_xml_dispatchif_request(3) and ne_xml_dispatch_request(3) are aliases of ne_xml_parse_response(3).