Analysis Software
Documentation for sPHENIX simulation software
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
tinyxml2::XMLPrinter Class Reference

#include <JETSCAPE/blob/main/external_packages/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)
 
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, int64_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 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 SealElementIfJustOpened ()
 

Protected Attributes

bool _elementJustOpened
 
DynArray< const char *, 10 > _stack
 

Private Types

enum  { ENTITY_RANGE = 64, BUF_SIZE = 200 }
 

Private Member Functions

void PrintString (const char *, bool restrictedEntitySet)
 

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

Definition at line 2051 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2051 of file tinyxml2.h

Member Enumeration Documentation

anonymous enum
private
Enumerator:
ENTITY_RANGE 
BUF_SIZE 

Definition at line 2160 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2160 of file tinyxml2.h

Constructor & Destructor Documentation

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 2276 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2276 of file tinyxml2.cc

References _buffer, _entityFlag, _restrictedEntityFlag, tinyxml2::entities, ENTITY_RANGE, i, tinyxml2::NUM_ENTITIES, tinyxml2::DynArray< T, INITIAL_SIZE_XML >::Push(), TIXMLASSERT, and tinyxml2::Entity::value.

+ Here is the call graph for this function:

virtual tinyxml2::XMLPrinter::~XMLPrinter ( )
inlinevirtual

Definition at line 2061 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2061 of file tinyxml2.h

Member Function Documentation

void tinyxml2::XMLPrinter::ClearBuffer ( )
inline

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

Definition at line 2132 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2132 of file tinyxml2.h

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

If streaming, close the Element.

Definition at line 2461 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2461 of file tinyxml2.cc

References _depth, _elementJustOpened, _stack, _textDepth, perf_headwind::name, tinyxml2::DynArray< T, INITIAL_SIZE_XML >::Pop(), Print(), and PrintSpace().

Referenced by VisitExit().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Definition at line 2138 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2138 of file tinyxml2.h

Referenced by VisitEnter(), and VisitExit().

+ Here is the caller graph for this function:

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

View newest version in sPHENIX GitHub at line 2117 of file tinyxml2.h

Referenced by Jetscape::JetScapeWriterStream< T >::WriteInitFileXMLMain(), and Jetscape::JetScapeWriterStream< T >::WriteInitFileXMLUser().

+ Here is the caller graph for this function:

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

View newest version in sPHENIX GitHub at line 2125 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 2393 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2393 of file tinyxml2.cc

References _depth, _elementJustOpened, _firstElement, _stack, _textDepth, Print(), PrintSpace(), tinyxml2::DynArray< T, INITIAL_SIZE_XML >::Push(), and SealElementIfJustOpened().

Referenced by VisitEnter().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Definition at line 2301 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2301 of file tinyxml2.cc

References _buffer, _fp, merge_hashes::p, tinyxml2::DynArray< T, INITIAL_SIZE_XML >::PushArr(), tinyxml2::DynArray< T, INITIAL_SIZE_XML >::Size(), TIXML_VSCPRINTF(), TIXML_VSNPRINTF, and TIXMLASSERT.

Referenced by CloseElement(), OpenElement(), PrintSpace(), PrintString(), PushAttribute(), PushComment(), PushDeclaration(), PushHeader(), PushText(), PushUnknown(), and SealElementIfJustOpened().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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 2323 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2323 of file tinyxml2.cc

References depth, i, and Print().

Referenced by CloseElement(), OpenElement(), PushComment(), PushDeclaration(), and PushUnknown().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Definition at line 2331 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2331 of file tinyxml2.cc

References _entityFlag, _processEntities, _restrictedEntityFlag, physmon_vertexing::delta, tinyxml2::entities, ENTITY_RANGE, i, tinyxml2::NUM_ENTITIES, merge_hashes::p, Print(), TIXMLASSERT, and value.

Referenced by PushAttribute(), and PushText().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

If streaming, add an attribute to an open element.

Definition at line 2412 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2412 of file tinyxml2.cc

References _elementJustOpened, Print(), PrintString(), and TIXMLASSERT.

Referenced by PushAttribute(), and VisitEnter().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Definition at line 2421 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2421 of file tinyxml2.cc

References BUF_SIZE, PushAttribute(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Definition at line 2429 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2429 of file tinyxml2.cc

References BUF_SIZE, PushAttribute(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Definition at line 2437 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2437 of file tinyxml2.cc

References BUF_SIZE, PushAttribute(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Definition at line 2445 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2445 of file tinyxml2.cc

References BUF_SIZE, PushAttribute(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Definition at line 2453 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2453 of file tinyxml2.cc

References BUF_SIZE, PushAttribute(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Add a comment.

Definition at line 2557 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2557 of file tinyxml2.cc

References _compactMode, _depth, _firstElement, _textDepth, Print(), PrintSpace(), and SealElementIfJustOpened().

Referenced by Visit().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Definition at line 2569 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2569 of file tinyxml2.cc

References _compactMode, _depth, _firstElement, _textDepth, Print(), PrintSpace(), and SealElementIfJustOpened().

Referenced by PushHeader(), and Visit().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

If streaming, write the BOM and declaration.

Definition at line 2381 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2381 of file tinyxml2.cc

References Print(), PushDeclaration(), TIXML_UTF_LEAD_0, TIXML_UTF_LEAD_1, and TIXML_UTF_LEAD_2.

Referenced by VisitEnter().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Add a text node.

Definition at line 2497 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2497 of file tinyxml2.cc

References _depth, _textDepth, Print(), PrintString(), and SealElementIfJustOpened().

Referenced by PushText(), and Visit().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Add a text node from an integer.

Definition at line 2517 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2517 of file tinyxml2.cc

References BUF_SIZE, PushText(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Add a text node from an unsigned.

Definition at line 2525 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2525 of file tinyxml2.cc

References BUF_SIZE, PushText(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Add a text node from an unsigned.

Definition at line 2510 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2510 of file tinyxml2.cc

References BUF_SIZE, PushText(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Add a text node from a bool.

Definition at line 2533 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2533 of file tinyxml2.cc

References BUF_SIZE, PushText(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Add a text node from a float.

Definition at line 2541 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2541 of file tinyxml2.cc

References BUF_SIZE, PushText(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Add a text node from a double.

Definition at line 2549 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2549 of file tinyxml2.cc

References BUF_SIZE, PushText(), and tinyxml2::XMLUtil::ToStr().

+ Here is the call graph for this function:

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

Definition at line 2581 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2581 of file tinyxml2.cc

References _compactMode, _depth, _firstElement, _textDepth, Print(), PrintSpace(), and SealElementIfJustOpened().

Referenced by Visit().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void tinyxml2::XMLPrinter::SealElementIfJustOpened ( )
protected

Definition at line 2487 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2487 of file tinyxml2.cc

References _elementJustOpened, and Print().

Referenced by OpenElement(), PushComment(), PushDeclaration(), PushText(), and PushUnknown().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

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

Visit a text node.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2626 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2626 of file tinyxml2.cc

References tinyxml2::XMLText::CData(), PushText(), and tinyxml2::XMLNode::Value().

+ Here is the call graph for this function:

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

Visit a comment node.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2633 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2633 of file tinyxml2.cc

References PushComment(), and tinyxml2::XMLNode::Value().

+ Here is the call graph for this function:

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

Visit a declaration.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2639 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2639 of file tinyxml2.cc

References PushDeclaration(), and tinyxml2::XMLNode::Value().

+ Here is the call graph for this function:

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

Visit an unknown node.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2646 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2646 of file tinyxml2.cc

References PushUnknown(), and tinyxml2::XMLNode::Value().

+ Here is the call graph for this function:

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

Visit a document.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2593 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2593 of file tinyxml2.cc

References _processEntities, tinyxml2::XMLDocument::HasBOM(), tinyxml2::XMLDocument::ProcessEntities(), and PushHeader().

+ Here is the call graph for this function:

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

Visit an element.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2603 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2603 of file tinyxml2.cc

References _compactMode, CompactMode(), tinyxml2::XMLAttribute::Name(), tinyxml2::XMLElement::Name(), tinyxml2::XMLAttribute::Next(), OpenElement(), tinyxml2::XMLNode::Parent(), PushAttribute(), tinyxml2::XMLNode::ToElement(), and tinyxml2::XMLAttribute::Value().

+ Here is the call graph for this function:

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

Visit a document.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2101 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2101 of file tinyxml2.h

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

Visit an element.

Reimplemented from tinyxml2::XMLVisitor.

Definition at line 2619 of file tinyxml2.cc.

View newest version in sPHENIX GitHub at line 2619 of file tinyxml2.cc

References CloseElement(), and CompactMode().

+ Here is the call graph for this function:

Member Data Documentation

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

Definition at line 2167 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2167 of file tinyxml2.h

Referenced by Print(), and XMLPrinter().

bool tinyxml2::XMLPrinter::_compactMode
private

Definition at line 2158 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2158 of file tinyxml2.h

Referenced by PushComment(), PushDeclaration(), PushUnknown(), and VisitEnter().

int tinyxml2::XMLPrinter::_depth
private

Definition at line 2155 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2155 of file tinyxml2.h

Referenced by CloseElement(), OpenElement(), PushComment(), PushDeclaration(), PushText(), and PushUnknown().

bool tinyxml2::XMLPrinter::_elementJustOpened
protected

Definition at line 2147 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2147 of file tinyxml2.h

Referenced by CloseElement(), OpenElement(), PushAttribute(), and SealElementIfJustOpened().

bool tinyxml2::XMLPrinter::_entityFlag[ENTITY_RANGE]
private

Definition at line 2164 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2164 of file tinyxml2.h

Referenced by PrintString(), and XMLPrinter().

bool tinyxml2::XMLPrinter::_firstElement
private

Definition at line 2153 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2153 of file tinyxml2.h

Referenced by OpenElement(), PushComment(), PushDeclaration(), and PushUnknown().

FILE* tinyxml2::XMLPrinter::_fp
private

Definition at line 2154 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2154 of file tinyxml2.h

Referenced by Print().

bool tinyxml2::XMLPrinter::_processEntities
private

Definition at line 2157 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2157 of file tinyxml2.h

Referenced by PrintString(), and VisitEnter().

bool tinyxml2::XMLPrinter::_restrictedEntityFlag[ENTITY_RANGE]
private

Definition at line 2165 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2165 of file tinyxml2.h

Referenced by PrintString(), and XMLPrinter().

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

Definition at line 2148 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2148 of file tinyxml2.h

Referenced by CloseElement(), and OpenElement().

int tinyxml2::XMLPrinter::_textDepth
private

Definition at line 2156 of file tinyxml2.h.

View newest version in sPHENIX GitHub at line 2156 of file tinyxml2.h

Referenced by CloseElement(), OpenElement(), PushComment(), PushDeclaration(), PushText(), and PushUnknown().


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