libwget-xml(3) Introduction to Library Functions libwget-xml(3)

NAME

libwget-xml - XML parsing functions

SYNOPSIS

Functions

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

Detailed Description
Function Documentation
int wget_xml_parse_buffer (const char * buf, wget_xml_callback *
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 *
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 *
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 *
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.

char * wget_xml_decode_entities_inline (char * src)
Parameters
src A string

Returns
A pointer to src, after the XML entities have been converted

Decode XML entities from src.

The transformation is done inline, so src will be modified after this
function returns. If no XML entities have been found, src is left
untouched.

Only a small subset of available XML entities is currently
recognized.

Author
Generated automatically by Doxygen for wget2 from the source code.

wget2 Version 2.2.0 libwget-xml(3)