DOM XML parser. More...

#include <libxml++/parsers/domparser.h>

Inheritance diagram for xmlpp::DomParser:

Public Member Functions
	DomParser ()
	Create a parser with an empty document. More...

	DomParser (const std::string & filename, bool validate=false)
	Instantiate the parser and parse a document immediately. More...

	~DomParser () override

const Document *	get_document () const noexcept
	Get the parsed document. More...

Document *	get_document () noexcept
	Get the parsed document. More...

void	get_xinclude_options (bool & process_xinclude, bool & generate_xinclude_nodes, bool & fixup_base_uris) const noexcept
	Get whether and how the parser will perform XInclude substitution. More...

	operator bool () const noexcept
	Test whether a document has been parsed. More...

void	parse_file (const std::string & filename) override
	Parse an XML document from a file. More...

void	parse_memory (const ustring & contents) override
	Parse an XML document from a string. More...

void	parse_memory_raw (const unsigned char * contents, size_type bytes_count) override
	Parse an XML document from raw memory. More...

void	parse_stream (std::istream & in) override
	Parse an XML document from a stream. More...

void	set_xinclude_options (bool process_xinclude=true, bool generate_xinclude_nodes=true, bool fixup_base_uris=true) noexcept
	Set whether and how the parser will perform XInclude substitution. More...

Public Member Functions inherited from xmlpp::Parser
	Parser ()

	~Parser () override

bool	get_include_default_attributes () const noexcept
	See set_include_default_attributes(). More...

void	get_parser_options (int & set_options, int & clear_options) const noexcept
	See set_parser_options(). More...

bool	get_substitute_entities () const noexcept
	See set_substitute_entities(). More...

bool	get_throw_messages () const noexcept
	See set_throw_messages(). More...

bool	get_validate () const noexcept
	See set_validate(). More...

void	set_include_default_attributes (bool val=true) noexcept
	Set whether default attribute values from the DTD shall be included in the node tree. More...

void	set_parser_options (int set_options=0, int clear_options=0) noexcept
	Set and/or clear parser option flags. More...

void	set_substitute_entities (bool val=true) noexcept
	Set whether the parser will automatically substitute entity references with the text of the entities' definitions. More...

void	set_throw_messages (bool val=true) noexcept
	Set whether the parser will collect and throw error and warning messages. More...

void	set_validate (bool val=true) noexcept
	By default, the parser will not validate the XML file. More...

Public Member Functions inherited from xmlpp::NonCopyable
	NonCopyable (const NonCopyable &)=delete

	NonCopyable (NonCopyable &&)=delete

NonCopyable &	operator= (const NonCopyable &)=delete

NonCopyable &	operator= (NonCopyable &&)=delete

Protected Member Functions
void	check_xinclude_and_finish_parsing ()

void	parse_context ()

void	release_underlying () override

Protected Member Functions inherited from xmlpp::Parser
virtual void	check_for_error_and_warning_messages ()

virtual void	check_for_exception ()

virtual void	handle_exception ()
	To be called in an exception handler. More...

virtual void	initialize_context ()

virtual void	on_parser_error (const ustring & message)

virtual void	on_parser_warning (const ustring & message)

virtual void	on_validity_error (const ustring & message)

virtual void	on_validity_warning (const ustring & message)

Protected Member Functions inherited from xmlpp::NonCopyable
	NonCopyable () noexcept

virtual	~NonCopyable ()

Protected Attributes
Document *	doc_

int	xinclude_options_ = 0

Protected Attributes inherited from xmlpp::Parser
_xmlParserCtxt *	context_

std::unique_ptr< exception >	exception_

Additional Inherited Members
Public Types inherited from xmlpp::Parser
using	size_type = unsigned int

Protected Types inherited from xmlpp::Parser
enum class	MsgType { ParserError , ParserWarning , ValidityError , ValidityWarning }

Static Protected Member Functions inherited from xmlpp::Parser
static void	callback_error_or_warning (bool is_parser, bool is_error, void * ctx, const char * msg, va_list var_args)

static void	callback_error_or_warning (MsgType msg_type, void * ctx, const char * msg, va_list var_args)

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 ParserCallbackCFuncType	get_callback_parser_error_cfunc ()

static ParserCallbackCFuncType	get_callback_parser_warning_cfunc ()

static ParserCallbackCFuncType	get_callback_validity_error_cfunc ()

static ParserCallbackCFuncType	get_callback_validity_warning_cfunc ()

Detailed Description

DOM XML parser.

DOM = Document Object Model

Constructor & Destructor Documentation

◆ DomParser() [1/2]

xmlpp::DomParser::DomParser ( )

Create a parser with an empty document.

Exceptions

xmlpp::internal_error If an empty document can't be created.

◆ DomParser() [2/2]

xmlpp::DomParser::DomParser	(	const std::string &	filename,
		bool	validate = `false`
	)

explicit

Instantiate the parser and parse a document immediately.

Parameters

filename	The path to the file.
validate	Whether the parser should validate the XML.

Exceptions

xmlpp::internal_error
xmlpp::parse_error
xmlpp::validity_error

◆ ~DomParser()

xmlpp::DomParser::~DomParser ( )

override

Member Function Documentation

◆ check_xinclude_and_finish_parsing()

void xmlpp::DomParser::check_xinclude_and_finish_parsing ( )

protected

◆ get_document() [1/2]

const Document* xmlpp::DomParser::get_document ( ) const

noexcept

Get the parsed document.

Returns: A pointer to the parsed document, or nullptr.

◆ get_document() [2/2]

Document* xmlpp::DomParser::get_document ( )

noexcept

Get the parsed document.

Returns: A pointer to the parsed document, or nullptr.

◆ get_xinclude_options()

void xmlpp::DomParser::get_xinclude_options	(	bool &	process_xinclude,
		bool &	generate_xinclude_nodes,
		bool &	fixup_base_uris
	)		const

noexcept

Get whether and how the parser will perform XInclude substitution.

Since libxml++ 3.2:

Parameters

[out]	process_xinclude	Do XInclude substitution on the XML document.
[out]	generate_xinclude_nodes	Generate XIncludeStart and XIncludeEnd nodes.
[out]	fixup_base_uris	Add or replace xml:base attributes in included element nodes, if necessary to preserve the target of relative URIs.

◆ operator bool()

xmlpp::DomParser::operator bool ( ) const

explicitnoexcept

Test whether a document has been parsed.

◆ parse_context()

void xmlpp::DomParser::parse_context ( )

protected

◆ parse_file()

void xmlpp::DomParser::parse_file ( const std::string & filename )

overridevirtual

Parse an XML document from a file.

If the parser already contains a document, that document and all its nodes are deleted.

Parameters

filename The path to the file.

Exceptions

xmlpp::internal_error
xmlpp::parse_error
xmlpp::validity_error

Implements xmlpp::Parser.

◆ parse_memory()

void xmlpp::DomParser::parse_memory ( const ustring & contents )

overridevirtual

Parse an XML document from a string.

If the parser already contains a document, that document and all its nodes are deleted.

Parameters

contents The XML document as a string.

Exceptions

xmlpp::internal_error
xmlpp::parse_error
xmlpp::validity_error

Implements xmlpp::Parser.

◆ parse_memory_raw()

void xmlpp::DomParser::parse_memory_raw	(	const unsigned char *	contents,
		size_type	bytes_count
	)

overridevirtual

Parse an XML document from raw memory.

If the parser already contains a document, that document and all its nodes are deleted.

Parameters

contents	The XML document as an array of bytes.
bytes_count	The number of bytes in the contents array.

Exceptions

xmlpp::internal_error
xmlpp::parse_error
xmlpp::validity_error

Implements xmlpp::Parser.

◆ parse_stream()

void xmlpp::DomParser::parse_stream ( std::istream & in )

overridevirtual

Parse an XML document from a stream.

If the parser already contains a document, that document and all its nodes are deleted.

Parameters

in	The stream.

Exceptions

xmlpp::internal_error
xmlpp::parse_error
xmlpp::validity_error

Implements xmlpp::Parser.

◆ release_underlying()

void xmlpp::DomParser::release_underlying ( )

overrideprotectedvirtual

Reimplemented from xmlpp::Parser.

◆ set_xinclude_options()

void xmlpp::DomParser::set_xinclude_options	(	bool	process_xinclude = `true`,
		bool	generate_xinclude_nodes = `true`,
		bool	fixup_base_uris = `true`
	)

noexcept

Set whether and how the parser will perform XInclude substitution.

Since libxml++ 3.2:

Parameters

process_xinclude	Do XInclude substitution on the XML document. If `false`, the other parameters have no effect.
generate_xinclude_nodes	Generate XIncludeStart and XIncludeEnd nodes.
fixup_base_uris	Add or replace xml:base attributes in included element nodes, if necessary to preserve the target of relative URIs.

Member Data Documentation

◆ doc_

Document* xmlpp::DomParser::doc_

protected

◆ xinclude_options_

int xmlpp::DomParser::xinclude_options_ = 0

protected

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ DomParser() [1/2]

◆ DomParser() [2/2]

◆ ~DomParser()

Member Function Documentation

◆ check_xinclude_and_finish_parsing()

◆ get_document() [1/2]

◆ get_document() [2/2]

◆ get_xinclude_options()

◆ operator bool()

◆ parse_context()

◆ parse_file()

◆ parse_memory()

◆ parse_memory_raw()

◆ parse_stream()

◆ release_underlying()

◆ set_xinclude_options()

Member Data Documentation

◆ doc_

◆ xinclude_options_