libwget-xml(3)

XML parsing functions

Section 3 wget2-dev bookworm source

Description

libwget-xml

NAME

libwget-xml - XML parsing functions

SYNOPSIS

Functions

int wget_xml_parse_buffer (const char *buf, wget_xml_callback_t callback, void *user_ctx, int hints)
void wget_html_parse_buffer (const char *buf, wget_xml_callback_t callback, void *user_ctx, int hints)
void wget_xml_parse_file (const char *fname, wget_xml_callback_t callback, void *user_ctx, int hints)
void wget_html_parse_file (const char *fname, wget_xml_callback_t callback, void *user_ctx, int hints)

Detailed Description

Function Documentation

int wget_xml_parse_buffer (const char * buf, wget_xml_callback_t callback,void * user_ctx, int hints)

Parameters

buf Zero-terminated XML or HTML input data
callback
Function called for each token scan result
user_ctx
User-defined context variable, handed to callback
hints
Flags to influence parsing

This function scans the XML input from buf and calls callback for each token found. user_ctx is a user-defined context variable and given to each call of callback.

hints may be 0 or any combination of XML_HINT_REMOVE_EMPTY_CONTENT and XML_HINT_HTML.

XML_HINT_REMOVE_EMPTY_CONTENT reduces the number of calls to callback by ignoring empty content and superfluous spaces.

XML_HINT_HTML turns on HTML scanning.

void wget_html_parse_buffer (const char * buf, wget_xml_callback_t callback,void * user_ctx, int hints)

Parameters

buf Zero-terminated HTML input data
callback
Function called for each token scan result
user_ctx
User-defined context variable, handed to callback
hints
Flags to influence parsing

Convenience function that calls wget_xml_parse_buffer() with HTML parsing turned on.

void wget_xml_parse_file (const char * fname, wget_xml_callback_t callback,void * user_ctx, int hints)

Parameters

fname Name of XML or HTML input file
callback
Function called for each token scan result
user_ctx
User-defined context variable, handed to callback
hints
Flags to influence parsing

Convenience function that calls wget_xml_parse_buffer() with the file content.

If fname is -, the data is read from stdin.

void wget_html_parse_file (const char * fname, wget_xml_callback_t callback,void * user_ctx, int hints)

Parameters

fname Name of XML or HTML input file
callback
Function called for each token scan result
user_ctx
User-defined context variable, handed to callback
hints
Flags to influence parsing

Convenience function that calls wget_xml_parse_file() with HTML parsing turned on.

If fname is -, the data is read from stdin.

Author

Generated automatically by Doxygen for wget2 from the source code.