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:

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:

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