tinyxml2::XMLPrinter Class Reference

#include <tinyxml2.h>

Inheritance diagram for tinyxml2::XMLPrinter:

Collaboration diagram for tinyxml2::XMLPrinter:

Public Member Functions
	XMLPrinter (FILE *file=0, bool compact=false, int depth=0)
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, int64_t value)
void	PushAttribute (const char *name, uint64_t 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 (int64_t value)
	Add a text node from a signed 64bit integer.
void	PushText (uint64_t value)
	Add a text node from an unsigned 64bit integer.
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 &) override
	Visit a document.
virtual bool	VisitExit (const XMLDocument &) override
	Visit a document.
virtual bool	VisitEnter (const XMLElement &element, const XMLAttribute *attribute) override
	Visit an element.
virtual bool	VisitExit (const XMLElement &element) override
	Visit an element.
virtual bool	Visit (const XMLText &text) override
	Visit a text node.
virtual bool	Visit (const XMLComment &comment) override
	Visit a comment node.
virtual bool	Visit (const XMLDeclaration &declaration) override
	Visit a declaration.
virtual bool	Visit (const XMLUnknown &unknown) override
	Visit an unknown node.
const char *	CStr () const
int	CStrSize () const
void	ClearBuffer (bool resetToFirstElement=true)

Protected Member Functions
virtual bool	CompactMode (const XMLElement &)
virtual void	PrintSpace (int depth)
virtual void	Print (const char *format,...)
virtual void	Write (const char *data, size_t size)
virtual void	Putc (char ch)
void	Write (const char *data)
void	SealElementIfJustOpened ()

Protected Attributes
bool	_elementJustOpened
DynArray< const char *, 10 >	_stack

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

Private Member Functions
void	PrepareForNewNode (bool compactMode)
void	PrintString (const char *, bool restrictedEntitySet)
	XMLPrinter (const XMLPrinter &)
XMLPrinter &	operator= (const XMLPrinter &)

Private Attributes
bool	_firstElement
FILE *	_fp
int	_depth
int	_textDepth
bool	_processEntities
bool	_compactMode
bool	_entityFlag [ENTITY_RANGE]
bool	_restrictedEntityFlag [ENTITY_RANGE]
DynArray< char, 20 >	_buffer

Detailed Description

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

It can:

1. Print to memory.
2. Print to a file you provide.
3. 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();

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.

Member Function Documentation

ClearBuffer()

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

inline

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

CStr()

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

inline

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

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

OpenElement()

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

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

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.

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

PushHeader()

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

If streaming, write the BOM and declaration.

Visit() [1/4]

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

overridevirtual

Visit a comment node.

Reimplemented from tinyxml2::XMLVisitor.

Visit() [2/4]

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

overridevirtual

Visit a declaration.

Reimplemented from tinyxml2::XMLVisitor.

Visit() [3/4]

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

overridevirtual

Visit a text node.

Reimplemented from tinyxml2::XMLVisitor.

Visit() [4/4]

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

overridevirtual

Visit an unknown node.

Reimplemented from tinyxml2::XMLVisitor.

VisitEnter() [1/2]

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

overridevirtual

Visit a document.

Reimplemented from tinyxml2::XMLVisitor.

VisitEnter() [2/2]

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

overridevirtual

Visit an element.

Reimplemented from tinyxml2::XMLVisitor.

VisitExit() [1/2]

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

inlineoverridevirtual

Visit a document.

Reimplemented from tinyxml2::XMLVisitor.

VisitExit() [2/2]

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

overridevirtual

Visit an element.

Reimplemented from tinyxml2::XMLVisitor.

---

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

• tarch/tinyxml2/tinyxml2.h