libxml++
2.36.0
|
SAX XML parser. More...
#include <libxml++/parsers/saxparser.h>
Classes | |
struct | Attribute |
Simple structure used in the start_element callback, in which the attributes are a list of name/value pairs. More... | |
struct | AttributeHasName |
This functor is a helper to find an attribute by name in an AttributeList using the standard algorithm std::find_if. More... |
Public Types | |
typedef std::deque< Attribute > | AttributeList |
![]() | |
typedef unsigned int | size_type |
Public Member Functions | |
SaxParser (bool use_get_entity=false) | |
virtual | ~SaxParser () |
virtual void | parse_file (const Glib::ustring& filename) |
Parse an XML document from a file. | |
virtual void | parse_memory (const Glib::ustring& contents) |
Parse an XML document from a string. | |
void | parse_memory_raw (const unsigned char* contents, size_type bytes_count) |
Parse an XML document from raw memory. | |
virtual void | parse_stream (std::istream& in) |
Parse an XML document from a stream. | |
virtual void | parse_chunk (const Glib::ustring& chunk) |
Parse a chunk of data. | |
void | parse_chunk_raw (const unsigned char* contents, size_type bytes_count) |
Parse a chunk of data. | |
virtual void | finish_chunk_parsing () |
Finish a chunk-wise parse. | |
![]() | |
Parser () | |
virtual | ~Parser () |
virtual void | set_validate (bool val=true) |
By default, the parser will not validate the XML file. | |
virtual bool | get_validate () const |
See set_validate() | |
virtual void | set_substitute_entities (bool val=true) |
Set whether the parser will automatically substitute entity references with the text of the entities' definitions. | |
virtual bool | get_substitute_entities () const |
See set_substitute_entities(). | |
void | set_throw_messages (bool val=true) |
Set whether the parser will collect and throw error and warning messages. | |
bool | get_throw_messages () const |
See set_throw_messages(). |
Protected Member Functions | |
virtual void | on_start_document () |
virtual void | on_end_document () |
virtual void | on_start_element (const Glib::ustring& name, const AttributeList& attributes) |
virtual void | on_end_element (const Glib::ustring& name) |
virtual void | on_characters (const Glib::ustring& characters) |
virtual void | on_comment (const Glib::ustring& text) |
virtual void | on_warning (const Glib::ustring& text) |
virtual void | on_error (const Glib::ustring& text) |
virtual void | on_fatal_error (const Glib::ustring& text) |
virtual void | on_cdata_block (const Glib::ustring& text) |
virtual void | on_internal_subset (const Glib::ustring& name, const Glib::ustring& publicId, const Glib::ustring& systemId) |
Override this to receive information about the document's DTD and any entity declarations. | |
virtual _xmlEntity* | on_get_entity (const Glib::ustring& name) |
Override this method to resolve entities references in your derived parser, instead of using the default entity resolution, or to be informed when entity references are encountered. | |
virtual void | on_entity_declaration (const Glib::ustring& name, XmlEntityType type, const Glib::ustring& publicId, const Glib::ustring& systemId, const Glib::ustring& content) |
Override this to receive information about every entity declaration. | |
virtual void | release_underlying () |
![]() | |
virtual void | initialize_context () |
virtual void | on_validity_error (const Glib::ustring& message) |
virtual void | on_validity_warning (const Glib::ustring& message) |
virtual void | handleException (const exception& e) |
virtual void | check_for_exception () |
virtual void | check_for_validity_messages () |
Additional Inherited Members | |
![]() | |
enum | MsgType { MsgParserError, MsgParserWarning, MsgValidityError, MsgValidityWarning } |
![]() | |
static void | callback_parser_error (void* ctx, const char* msg,...) |
static void | callback_parser_warning (void* ctx, const char* msg,...) |
static void | callback_validity_error (void* ctx, const char* msg,...) |
static void | callback_validity_warning (void* ctx, const char* msg,...) |
static void | callback_error_or_warning (MsgType msg_type, void* ctx, const char* msg, va_list var_args) |
![]() | |
_xmlParserCtxt* | context_ |
exception* | exception_ |
Glib::ustring | validate_error_ |
Glib::ustring | validate_warning_ |
bool | validate_ |
bool | substitute_entities_ |
SAX XML parser.
Derive your own class and override the on_*() methods.
typedef std::deque< Attribute > xmlpp::SaxParser::AttributeList |
xmlpp::SaxParser::SaxParser | ( | bool | use_get_entity = false | ) |
use_get_entity | Set this to true if you will override on_get_entity(). In theory, if you do not override on_get_entity() the parser should behave exactly the same whether you use true or false here. But the default implementation of on_get_entity(), needed if you override on_get_entity() might not have the same behaviour as the underlying default behaviour of libxml, so the libxml implementation is the default here. |
|
virtual |
|
virtual |
Finish a chunk-wise parse.
Call this after the last call to parse_chunk(). Don't use this function with the other parsing methods.
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
Override this to receive information about every entity declaration.
If you override this function, and you want normal entity substitution to work, then you must call the base class in your override.
This would be useful when overriding on_get_entity().
xmlpp::internal_error |
|
protectedvirtual |
|
protectedvirtual |
xmlpp::parse_error |
|
protectedvirtual |
Override this method to resolve entities references in your derived parser, instead of using the default entity resolution, or to be informed when entity references are encountered.
If you override this function then you must also specify true for use_get_entity constructor parameter. You will probably need to override on_entity_declaration() as well so that you can use that information when resolving the entity reference.
This is known to be difficult, because it requires both an understanding of the W3C specifications and knowledge of the libxml internals. Entity resolution is easier with the DomParser.
Call this method in this base class for default processing. For instance, if you just want to know about the existence of an entity reference, without affecting the normal substitution, just override and call the base class.
Unlike the DomParser, the SaxParser will also tell you about entity references for the 5 predefined entities.
name | The entity reference name. |
0
if not found. You must include libxml/parser.h in order to use this C struct. This instance will not be freed by the caller.
|
protectedvirtual |
Override this to receive information about the document's DTD and any entity declarations.
|
protectedvirtual |
|
protectedvirtual |
|
protectedvirtual |
|
virtual |
Parse a chunk of data.
This lets you pass a document in small chunks, e.g. from a network connection. The on_* virtual functions are called each time the chunks provide enough information to advance the parser.
The first call to parse_chunk will setup the parser. When the last chunk has been parsed, call finish_chunk_parsing() to finish the parse.
chunk | The next piece of the XML document. |
void xmlpp::SaxParser::parse_chunk_raw | ( | const unsigned char * | contents, |
size_type | bytes_count | ||
) |
Parse a chunk of data.
This lets you pass a document in small chunks, e.g. from a network connection. The on_* virtual functions are called each time the chunks provide enough information to advance the parser.
The first call to parse_chunk will setup the parser. When the last chunk has been parsed, call finish_chunk_parsing() to finish the parse.
contents | The next piece of the XML document as an array of bytes. |
bytes_count | The number of bytes in the contents array. |
|
virtual |
Parse an XML document from a file.
filename | The path to the file. |
Implements xmlpp::Parser.
|
virtual |
Parse an XML document from a string.
contents | The XML document as a string. |
Implements xmlpp::Parser.
void xmlpp::SaxParser::parse_memory_raw | ( | const unsigned char * | contents, |
size_type | bytes_count | ||
) |
Parse an XML document from raw memory.
contents | The XML document as an array of bytes. |
bytes_count | The number of bytes in the contents array. |
|
virtual |
|
protectedvirtual |
Reimplemented from xmlpp::Parser.