#include <tinyxml2.h>

Inheritance diagram for tinyxml2::XMLPrinter:

Public Member Functions
void	ClearBuffer (bool resetToFirstElement=true)

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

const char *	CStr () const

int	CStrSize () const

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

void	PushAttribute (const char *name, bool value)

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

void	PushAttribute (const char *name, double value)

void	PushAttribute (const char *name, int value)

void	PushAttribute (const char *name, int64_t value)

void	PushAttribute (const char *name, uint64_t value)

void	PushAttribute (const char *name, unsigned value)

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

void	PushDeclaration (const char *value)

void	PushHeader (bool writeBOM, bool writeDeclaration)

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

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

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

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

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

void	PushText (int64_t value)
	Add a text node from a signed 64bit integer. More...

void	PushText (uint64_t value)
	Add a text node from an unsigned 64bit integer. More...

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

void	PushUnknown (const char *value)

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

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

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

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

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

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

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

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

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

virtual	~XMLPrinter ()

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

Protected Member Functions
virtual bool	CompactMode (const XMLElement &)

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

virtual void	PrintSpace (int depth)

virtual void	Putc (char ch)

void	SealElementIfJustOpened ()

void	Write (const char *data)

virtual void	Write (const char *data, size_t size)

Protected Attributes
bool	_elementJustOpened

DynArray< const char *, 10 >	_stack

Private Types
enum	{ ENTITY_RANGE = 64, BUF_SIZE = 200 }

Private Member Functions
XMLPrinter &	operator= (const XMLPrinter &)

void	PrepareForNewNode (bool compactMode)

void	PrintString (const char *, bool restrictedEntitySet)

	XMLPrinter (const XMLPrinter &)

Private Attributes
DynArray< char, 20 >	_buffer

bool	_compactMode

int	_depth

bool	_entityFlag [ENTITY_RANGE]

bool	_firstElement

FILE *	_fp

bool	_processEntities

bool	_restrictedEntityFlag [ENTITY_RANGE]

int	_textDepth

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 2241 of file tinyxml2.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

private

Enumerator
ENTITY_RANGE
BUF_SIZE

Definition at line 2363 of file tinyxml2.h.

Constructor & Destructor Documentation

◆ XMLPrinter() [1/2]

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.

Definition at line 2592 of file tinyxml2.cpp.

◆ ~XMLPrinter()

virtual tinyxml2::XMLPrinter::~XMLPrinter ( )

inlinevirtual

Definition at line 2251 of file tinyxml2.h.

◆ XMLPrinter() [2/2]

tinyxml2::XMLPrinter::XMLPrinter ( const XMLPrinter & )

private

Member Function Documentation

◆ ClearBuffer()

void tinyxml2::XMLPrinter::ClearBuffer ( bool resetToFirstElement = true )

inline

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

Definition at line 2325 of file tinyxml2.h.

◆ CloseElement()

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

virtual

If streaming, close the Element.

Definition at line 2832 of file tinyxml2.cpp.

◆ CompactMode()

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

inlineprotectedvirtual

Definition at line 2332 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 2310 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 2318 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()

Definition at line 2760 of file tinyxml2.cpp.

◆ operator=()

XMLPrinter& tinyxml2::XMLPrinter::operator= ( const XMLPrinter & )

private

◆ PrepareForNewNode()

void tinyxml2::XMLPrinter::PrepareForNewNode ( bool compactMode )

private

Prepares to write a new node. This includes sealing an element that was just opened, and writing any whitespace necessary if not in compact mode.

Definition at line 2742 of file tinyxml2.cpp.

◆ Print()

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

protectedvirtual

Definition at line 2620 of file tinyxml2.cpp.

◆ PrintSpace()

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().

Definition at line 2668 of file tinyxml2.cpp.

◆ PrintString()

void tinyxml2::XMLPrinter::PrintString	(	const char *	p,
		bool	restrictedEntitySet
	)

private

Definition at line 2676 of file tinyxml2.cpp.

◆ PushAttribute() [1/7]

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

Definition at line 2816 of file tinyxml2.cpp.

◆ PushAttribute() [2/7]

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

If streaming, add an attribute to an open element.

Definition at line 2773 of file tinyxml2.cpp.

◆ PushAttribute() [3/7]

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

Definition at line 2824 of file tinyxml2.cpp.

◆ PushAttribute() [4/7]

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

Definition at line 2784 of file tinyxml2.cpp.

◆ PushAttribute() [5/7]

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

Definition at line 2800 of file tinyxml2.cpp.

◆ PushAttribute() [6/7]

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

Definition at line 2808 of file tinyxml2.cpp.

◆ PushAttribute() [7/7]

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

Definition at line 2792 of file tinyxml2.cpp.

◆ PushComment()

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

Add a comment.

Definition at line 2942 of file tinyxml2.cpp.

◆ PushDeclaration()

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

Definition at line 2952 of file tinyxml2.cpp.

◆ PushHeader()

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

If streaming, write the BOM and declaration.

Definition at line 2731 of file tinyxml2.cpp.

◆ PushText() [1/8]

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

Add a text node from a bool.

Definition at line 2918 of file tinyxml2.cpp.

◆ PushText() [2/8]

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

Add a text node.

Definition at line 2870 of file tinyxml2.cpp.

◆ PushText() [3/8]

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

Add a text node from a double.

Definition at line 2934 of file tinyxml2.cpp.

◆ PushText() [4/8]

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

Add a text node from a float.

Definition at line 2926 of file tinyxml2.cpp.

◆ PushText() [5/8]

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

Add a text node from an integer.

Definition at line 2902 of file tinyxml2.cpp.

◆ PushText() [6/8]

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

Add a text node from a signed 64bit integer.

Definition at line 2886 of file tinyxml2.cpp.

◆ PushText() [7/8]

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

Add a text node from an unsigned 64bit integer.

Definition at line 2894 of file tinyxml2.cpp.

◆ PushText() [8/8]

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

Add a text node from an unsigned.

Definition at line 2910 of file tinyxml2.cpp.

◆ PushUnknown()

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

Definition at line 2962 of file tinyxml2.cpp.

◆ Putc()

void tinyxml2::XMLPrinter::Putc ( char ch )

protectedvirtual

Definition at line 2655 of file tinyxml2.cpp.

◆ SealElementIfJustOpened()

void tinyxml2::XMLPrinter::SealElementIfJustOpened ( )

protected

Definition at line 2860 of file tinyxml2.cpp.

◆ Visit() [1/4]

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

overridevirtual

Visit a comment node.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 3012 of file tinyxml2.cpp.

◆ Visit() [2/4]

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

overridevirtual

Visit a declaration.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 3018 of file tinyxml2.cpp.

◆ Visit() [3/4]

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

overridevirtual

Visit a text node.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 3005 of file tinyxml2.cpp.

◆ Visit() [4/4]

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

overridevirtual

Visit an unknown node.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 3025 of file tinyxml2.cpp.

◆ VisitEnter() [1/2]

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

overridevirtual

Visit a document.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2972 of file tinyxml2.cpp.

◆ VisitEnter() [2/2]

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

overridevirtual

Visit an element.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2982 of file tinyxml2.cpp.

◆ VisitExit() [1/2]

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

inlineoverridevirtual

Visit a document.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2294 of file tinyxml2.h.

◆ VisitExit() [2/2]

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

overridevirtual

Visit an element.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2998 of file tinyxml2.cpp.

◆ Write() [1/2]

void tinyxml2::XMLPrinter::Write ( const char * data )

inlineprotected

Definition at line 2342 of file tinyxml2.h.

◆ Write() [2/2]

void tinyxml2::XMLPrinter::Write	(	const char *	data,
		size_t	size
	)

protectedvirtual

Definition at line 2642 of file tinyxml2.cpp.

Member Data Documentation

◆ _buffer

DynArray< char, 20 > tinyxml2::XMLPrinter::_buffer

private

Definition at line 2370 of file tinyxml2.h.

◆ _compactMode

bool tinyxml2::XMLPrinter::_compactMode

private

Definition at line 2361 of file tinyxml2.h.

◆ _depth

int tinyxml2::XMLPrinter::_depth

private

Definition at line 2358 of file tinyxml2.h.

◆ _elementJustOpened

bool tinyxml2::XMLPrinter::_elementJustOpened

protected

Definition at line 2345 of file tinyxml2.h.

◆ _entityFlag

bool tinyxml2::XMLPrinter::_entityFlag[ENTITY_RANGE]

private

Definition at line 2367 of file tinyxml2.h.

◆ _firstElement

bool tinyxml2::XMLPrinter::_firstElement

private

Definition at line 2356 of file tinyxml2.h.

◆ _fp

FILE* tinyxml2::XMLPrinter::_fp

private

Definition at line 2357 of file tinyxml2.h.

◆ _processEntities

bool tinyxml2::XMLPrinter::_processEntities

private

Definition at line 2360 of file tinyxml2.h.

◆ _restrictedEntityFlag

bool tinyxml2::XMLPrinter::_restrictedEntityFlag[ENTITY_RANGE]

private

Definition at line 2368 of file tinyxml2.h.

◆ _stack

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

protected

Definition at line 2346 of file tinyxml2.h.

◆ _textDepth

int tinyxml2::XMLPrinter::_textDepth

private

Definition at line 2359 of file tinyxml2.h.

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

Public Member Functions

Protected Member Functions

Protected Attributes

Private Types

Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ XMLPrinter() [1/2]

◆ ~XMLPrinter()

◆ XMLPrinter() [2/2]

Member Function Documentation

◆ ClearBuffer()

◆ CloseElement()

◆ CompactMode()

◆ CStr()

◆ CStrSize()

◆ OpenElement()

◆ operator=()

◆ PrepareForNewNode()

◆ Print()

◆ PrintSpace()

◆ PrintString()

◆ PushAttribute() [1/7]

◆ PushAttribute() [2/7]

◆ PushAttribute() [3/7]

◆ PushAttribute() [4/7]

◆ PushAttribute() [5/7]

◆ PushAttribute() [6/7]

◆ PushAttribute() [7/7]

◆ PushComment()

◆ PushDeclaration()

◆ PushHeader()

◆ PushText() [1/8]

◆ PushText() [2/8]

◆ PushText() [3/8]

◆ PushText() [4/8]

◆ PushText() [5/8]

◆ PushText() [6/8]

◆ PushText() [7/8]

◆ PushText() [8/8]

◆ PushUnknown()

◆ Putc()

◆ SealElementIfJustOpened()

◆ Visit() [1/4]

◆ Visit() [2/4]

◆ Visit() [3/4]

◆ Visit() [4/4]

◆ VisitEnter() [1/2]

◆ VisitEnter() [2/2]

◆ VisitExit() [1/2]

◆ VisitExit() [2/2]

◆ Write() [1/2]

◆ Write() [2/2]

Member Data Documentation

◆ _buffer

◆ _compactMode

◆ _depth

◆ _elementJustOpened

◆ _entityFlag

◆ _firstElement

◆ _fp

◆ _processEntities

◆ _restrictedEntityFlag

◆ _stack

◆ _textDepth