NAME

       ne_xml_parse_response, ne_xml_dispatch_request, ne_xml_dispatchif_request - helper functions for parsing
       XML responses

SYNOPSIS

       #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);

DESCRIPTION

       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..

RETURN VALUE

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

HISTORY

       ne_xml_dispatchif_request is available in neon 0.36.0 and later.

SEE ALSO

       ne_xml_create, ne_request_dispatch

COPYRIGHT

       Copyright © 2001-2025 Joe Orton

REFERENCES

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

neon 0.0.0-dev                                  28 November 2025                         NE_XML_PARSE_RESPONS(3)