#include <tinyxml2.h>

Inheritance diagram for tinyxml2::XMLPrinter:

Public Member Functions
	XMLPrinter (FILE *file=0, bool compact=false, int depth=0)

virtual	~XMLPrinter ()

void	PushHeader (bool writeBOM, bool writeDeclaration)

void	OpenElement (const char *name, bool compactMode=false)

void	PushAttribute (const char name, const char value)
	If streaming, add an attribute to an open element.

void	PushAttribute (const char *name, int value)

void	PushAttribute (const char *name, unsigned value)

void	PushAttribute (const char *name, bool value)

void	PushAttribute (const char *name, double value)

virtual void	CloseElement (bool compactMode=false)
	If streaming, close the Element.

void	PushText (const char *text, bool cdata=false)
	Add a text node.

void	PushText (int value)
	Add a text node from an integer.

void	PushText (unsigned value)
	Add a text node from an unsigned.

void	PushText (bool value)
	Add a text node from a bool.

void	PushText (float value)
	Add a text node from a float.

void	PushText (double value)
	Add a text node from a double.

void	PushComment (const char *comment)
	Add a comment.

void	PushDeclaration (const char *value)

void	PushUnknown (const char *value)

virtual bool	VisitEnter (const XMLDocument &)
	Visit a document.

virtual bool	VisitExit (const XMLDocument &)
	Visit a document.

virtual bool	VisitEnter (const XMLElement &element, const XMLAttribute *attribute)
	Visit an element.

virtual bool	VisitExit (const XMLElement &element)
	Visit an element.

virtual bool	Visit (const XMLText &text)
	Visit a text node.

virtual bool	Visit (const XMLComment &comment)
	Visit a comment node.

virtual bool	Visit (const XMLDeclaration &declaration)
	Visit a declaration.

virtual bool	Visit (const XMLUnknown &unknown)
	Visit an unknown node.

const char *	CStr () const

int	CStrSize () const

void	ClearBuffer ()

Public Member Functions inherited from tinyxml2::XMLVisitor
virtual	~XMLVisitor ()

Protected Member Functions
virtual bool	CompactMode (const XMLElement &)

virtual void	PrintSpace (int depth)

void	Print (const char *format,...)

void	SealElement ()

Protected Attributes
bool	_elementJustOpened

DynArray< const char *, 10 >	_stack

Detailed Description

Printing functionality. The XMLPrinter gives you more options than the XMLDocument::Print() method.

It can:

Print to memory.
Print to a file you provide.
Print XML without a XMLDocument.

Print to Memory

XMLPrinter printer;
doc.Print( &printer );
SomeFunction( printer.CStr() );

Print to a File

You provide the file pointer.

XMLPrinter printer( fp );
doc.Print( &printer );

Print without a XMLDocument

When loading, an XML parser is very useful. However, sometimes when saving, it just gets in the way. The code is often set up for streaming, and constructing the DOM is just overhead.

The Printer supports the streaming case. The following code prints out a trivially simple XML file without ever creating an XML document.

XMLPrinter printer( fp );
printer.OpenElement( "foo" );
printer.PushAttribute( "foo", "bar" );
printer.CloseElement();

Definition at line 1950 of file tinyxml2.h.

Constructor & Destructor Documentation

◆ XMLPrinter()

tinyxml2::XMLPrinter::XMLPrinter	(	FILE *	file = `0`,
		bool	compact = `false`,
		int	depth = `0`
	)

Construct the printer. If the FILE* is specified, this will print to the FILE. Else it will print to memory, and the result is available in CStr(). If 'compact' is set to true, then output is created with only required whitespace and newlines.

◆ ~XMLPrinter()

virtual tinyxml2::XMLPrinter::~XMLPrinter ( )

inlinevirtual

Definition at line 1960 of file tinyxml2.h.

Member Function Documentation

◆ ClearBuffer()

void tinyxml2::XMLPrinter::ClearBuffer ( )

inline

If in print to memory mode, reset the buffer to the beginning.

Definition at line 2028 of file tinyxml2.h.

◆ CloseElement()

virtual void tinyxml2::XMLPrinter::CloseElement ( bool compactMode = false )

virtual

If streaming, close the Element.

◆ CompactMode()

virtual bool tinyxml2::XMLPrinter::CompactMode ( const XMLElement & )

inlineprotectedvirtual

Definition at line 2034 of file tinyxml2.h.

◆ CStr()

const char * tinyxml2::XMLPrinter::CStr ( ) const

inline

If in print to memory mode, return a pointer to the XML file in memory.

Definition at line 2013 of file tinyxml2.h.

◆ CStrSize()

int tinyxml2::XMLPrinter::CStrSize ( ) const

inline

If in print to memory mode, return the size of the XML file in memory. (Note the size returned includes the terminating null.)

Definition at line 2021 of file tinyxml2.h.

◆ OpenElement()

void tinyxml2::XMLPrinter::OpenElement	(	const char *	name,
		bool	compactMode = `false`
	)

If streaming, start writing an element. The element must be closed with CloseElement()

◆ Print()

void tinyxml2::XMLPrinter::Print	(	const char *	format,
			...
	)

protected

◆ PrintSpace()

virtual void tinyxml2::XMLPrinter::PrintSpace ( int depth )

protectedvirtual

Prints out the space before an element. You may override to change the space and tabs used. A PrintSpace() override should call Print().

◆ PushAttribute() [1/5]

void tinyxml2::XMLPrinter::PushAttribute	(	const char *	name,
		bool	value
	)

◆ PushAttribute() [2/5]

void tinyxml2::XMLPrinter::PushAttribute	(	const char *	name,
		const char *	value
	)

If streaming, add an attribute to an open element.

◆ PushAttribute() [3/5]

void tinyxml2::XMLPrinter::PushAttribute	(	const char *	name,
		double	value
	)

◆ PushAttribute() [4/5]

void tinyxml2::XMLPrinter::PushAttribute	(	const char *	name,
		int	value
	)

◆ PushAttribute() [5/5]

void tinyxml2::XMLPrinter::PushAttribute	(	const char *	name,
		unsigned	value
	)

◆ PushComment()

void tinyxml2::XMLPrinter::PushComment ( const char * comment )

Add a comment.

◆ PushDeclaration()

void tinyxml2::XMLPrinter::PushDeclaration ( const char * value )

◆ PushHeader()

void tinyxml2::XMLPrinter::PushHeader	(	bool	writeBOM,
		bool	writeDeclaration
	)

If streaming, write the BOM and declaration.

◆ PushText() [1/6]

void tinyxml2::XMLPrinter::PushText ( bool value )

Add a text node from a bool.

◆ PushText() [2/6]

void tinyxml2::XMLPrinter::PushText	(	const char *	text,
		bool	cdata = `false`
	)

Add a text node.

◆ PushText() [3/6]

void tinyxml2::XMLPrinter::PushText ( double value )

Add a text node from a double.

◆ PushText() [4/6]

void tinyxml2::XMLPrinter::PushText ( float value )

Add a text node from a float.

◆ PushText() [5/6]

void tinyxml2::XMLPrinter::PushText ( int value )

Add a text node from an integer.

◆ PushText() [6/6]

void tinyxml2::XMLPrinter::PushText ( unsigned value )

Add a text node from an unsigned.

◆ PushUnknown()

void tinyxml2::XMLPrinter::PushUnknown ( const char * value )

◆ SealElement()

void tinyxml2::XMLPrinter::SealElement ( )

protected

◆ Visit() [1/4]

virtual bool tinyxml2::XMLPrinter::Visit ( const XMLComment & )

virtual

Visit a comment node.

Reimplemented from tinyxml2::XMLVisitor.

◆ Visit() [2/4]

virtual bool tinyxml2::XMLPrinter::Visit ( const XMLDeclaration & )

virtual

Visit a declaration.

Reimplemented from tinyxml2::XMLVisitor.

◆ Visit() [3/4]

virtual bool tinyxml2::XMLPrinter::Visit ( const XMLText & )

virtual

Visit a text node.

Reimplemented from tinyxml2::XMLVisitor.

◆ Visit() [4/4]

virtual bool tinyxml2::XMLPrinter::Visit ( const XMLUnknown & )

virtual

Visit an unknown node.

Reimplemented from tinyxml2::XMLVisitor.

◆ VisitEnter() [1/2]

virtual bool tinyxml2::XMLPrinter::VisitEnter ( const XMLDocument & )

virtual

Visit a document.

Reimplemented from tinyxml2::XMLVisitor.

◆ VisitEnter() [2/2]

virtual bool tinyxml2::XMLPrinter::VisitEnter	(	const XMLElement &	,
		const XMLAttribute *
	)

virtual

Visit an element.

Reimplemented from tinyxml2::XMLVisitor.

◆ VisitExit() [1/2]

virtual bool tinyxml2::XMLPrinter::VisitExit ( const XMLDocument & )

inlinevirtual

Visit a document.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 1997 of file tinyxml2.h.

◆ VisitExit() [2/2]

virtual bool tinyxml2::XMLPrinter::VisitExit ( const XMLElement & )

virtual

Visit an element.

Reimplemented from tinyxml2::XMLVisitor.

Member Data Documentation

◆ _elementJustOpened

bool tinyxml2::XMLPrinter::_elementJustOpened

protected

Definition at line 2043 of file tinyxml2.h.

◆ _stack

DynArray< const char*, 10 > tinyxml2::XMLPrinter::_stack

protected

Definition at line 2044 of file tinyxml2.h.

The documentation for this class was generated from the following file:

include/SO3SceneLoader/tinyxml2.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ XMLPrinter()

◆ ~XMLPrinter()

Member Function Documentation

◆ ClearBuffer()

◆ CloseElement()

◆ CompactMode()

◆ CStr()

◆ CStrSize()

◆ OpenElement()

◆ Print()

◆ PrintSpace()

◆ PushAttribute() [1/5]

◆ PushAttribute() [2/5]

◆ PushAttribute() [3/5]

◆ PushAttribute() [4/5]

◆ PushAttribute() [5/5]

◆ PushComment()

◆ PushDeclaration()

◆ PushHeader()

◆ PushText() [1/6]

◆ PushText() [2/6]

◆ PushText() [3/6]

◆ PushText() [4/6]

◆ PushText() [5/6]

◆ PushText() [6/6]

◆ PushUnknown()

◆ SealElement()

◆ Visit() [1/4]

◆ Visit() [2/4]

◆ Visit() [3/4]

◆ Visit() [4/4]

◆ VisitEnter() [1/2]

◆ VisitEnter() [2/2]

◆ VisitExit() [1/2]

◆ VisitExit() [2/2]

Member Data Documentation

◆ _elementJustOpened

◆ _stack