#include <tinyxml2.h>
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) |
Visit a comment node. More... | |
virtual bool | Visit (const XMLDeclaration &declaration) |
Visit a declaration. More... | |
virtual bool | Visit (const XMLText &text) |
Visit a text node. More... | |
virtual bool | Visit (const XMLUnknown &unknown) |
Visit an unknown node. More... | |
virtual bool | VisitEnter (const XMLDocument &) |
Visit a document. More... | |
virtual bool | VisitEnter (const XMLElement &element, const XMLAttribute *attribute) |
Visit an element. More... | |
virtual bool | VisitExit (const XMLDocument &) |
Visit a document. More... | |
virtual bool | VisitExit (const XMLElement &element) |
Visit an element. More... | |
XMLPrinter (FILE *file=0, bool compact=false, int depth=0) | |
virtual | ~XMLPrinter () |
![]() | |
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 |
Printing functionality. The XMLPrinter gives you more options than the XMLDocument::Print() method.
It can:
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 2237 of file tinyxml2.h.
|
private |
Enumerator | |
---|---|
ENTITY_RANGE | |
BUF_SIZE |
Definition at line 2359 of file tinyxml2.h.
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 2547 of file tinyxml2.cpp.
|
inlinevirtual |
Definition at line 2247 of file tinyxml2.h.
|
private |
|
inline |
If in print to memory mode, reset the buffer to the beginning.
Definition at line 2321 of file tinyxml2.h.
|
virtual |
If streaming, close the Element.
Definition at line 2787 of file tinyxml2.cpp.
|
inlineprotectedvirtual |
Definition at line 2328 of file tinyxml2.h.
|
inline |
If in print to memory mode, return a pointer to the XML file in memory.
Definition at line 2306 of file tinyxml2.h.
|
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 2314 of file tinyxml2.h.
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 2715 of file tinyxml2.cpp.
|
private |
|
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 2697 of file tinyxml2.cpp.
|
protectedvirtual |
Definition at line 2575 of file tinyxml2.cpp.
|
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 2623 of file tinyxml2.cpp.
|
private |
Definition at line 2631 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushAttribute | ( | const char * | name, |
bool | value | ||
) |
Definition at line 2771 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushAttribute | ( | const char * | name, |
const char * | value | ||
) |
If streaming, add an attribute to an open element.
Definition at line 2728 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushAttribute | ( | const char * | name, |
double | value | ||
) |
Definition at line 2779 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushAttribute | ( | const char * | name, |
int | value | ||
) |
Definition at line 2739 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushAttribute | ( | const char * | name, |
int64_t | value | ||
) |
Definition at line 2755 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushAttribute | ( | const char * | name, |
uint64_t | value | ||
) |
Definition at line 2763 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushAttribute | ( | const char * | name, |
unsigned | value | ||
) |
Definition at line 2747 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushComment | ( | const char * | comment | ) |
Add a comment.
Definition at line 2897 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushDeclaration | ( | const char * | value | ) |
Definition at line 2907 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushHeader | ( | bool | writeBOM, |
bool | writeDeclaration | ||
) |
If streaming, write the BOM and declaration.
Definition at line 2686 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushText | ( | bool | value | ) |
Add a text node from a bool.
Definition at line 2873 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushText | ( | const char * | text, |
bool | cdata = false |
||
) |
Add a text node.
Definition at line 2825 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushText | ( | double | value | ) |
Add a text node from a double.
Definition at line 2889 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushText | ( | float | value | ) |
Add a text node from a float.
Definition at line 2881 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushText | ( | int | value | ) |
Add a text node from an integer.
Definition at line 2857 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushText | ( | int64_t | value | ) |
Add a text node from a signed 64bit integer.
Definition at line 2841 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushText | ( | uint64_t | value | ) |
Add a text node from an unsigned 64bit integer.
Definition at line 2849 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushText | ( | unsigned | value | ) |
Add a text node from an unsigned.
Definition at line 2865 of file tinyxml2.cpp.
void tinyxml2::XMLPrinter::PushUnknown | ( | const char * | value | ) |
Definition at line 2917 of file tinyxml2.cpp.
|
protectedvirtual |
Definition at line 2610 of file tinyxml2.cpp.
|
protected |
Definition at line 2815 of file tinyxml2.cpp.
|
virtual |
Visit a comment node.
Reimplemented from tinyxml2::XMLVisitor.
Definition at line 2967 of file tinyxml2.cpp.
|
virtual |
Visit a declaration.
Reimplemented from tinyxml2::XMLVisitor.
Definition at line 2973 of file tinyxml2.cpp.
|
virtual |
Visit a text node.
Reimplemented from tinyxml2::XMLVisitor.
Definition at line 2960 of file tinyxml2.cpp.
|
virtual |
Visit an unknown node.
Reimplemented from tinyxml2::XMLVisitor.
Definition at line 2980 of file tinyxml2.cpp.
|
virtual |
Visit a document.
Reimplemented from tinyxml2::XMLVisitor.
Definition at line 2927 of file tinyxml2.cpp.
|
virtual |
Visit an element.
Reimplemented from tinyxml2::XMLVisitor.
Definition at line 2937 of file tinyxml2.cpp.
|
inlinevirtual |
Visit a document.
Reimplemented from tinyxml2::XMLVisitor.
Definition at line 2290 of file tinyxml2.h.
|
virtual |
Visit an element.
Reimplemented from tinyxml2::XMLVisitor.
Definition at line 2953 of file tinyxml2.cpp.
|
inlineprotected |
Definition at line 2338 of file tinyxml2.h.
|
protectedvirtual |
Definition at line 2597 of file tinyxml2.cpp.
|
private |
Definition at line 2366 of file tinyxml2.h.
|
private |
Definition at line 2357 of file tinyxml2.h.
|
private |
Definition at line 2354 of file tinyxml2.h.
|
protected |
Definition at line 2341 of file tinyxml2.h.
|
private |
Definition at line 2363 of file tinyxml2.h.
|
private |
Definition at line 2352 of file tinyxml2.h.
|
private |
Definition at line 2353 of file tinyxml2.h.
|
private |
Definition at line 2356 of file tinyxml2.h.
|
private |
Definition at line 2364 of file tinyxml2.h.
|
protected |
Definition at line 2342 of file tinyxml2.h.
|
private |
Definition at line 2355 of file tinyxml2.h.