Merge pull request #114 from Vasily-Biryukov/doc

Small fixes in documentation
This commit is contained in:
Lee Thomason 2013-05-20 13:00:15 -07:00
commit 392bcd2485
2 changed files with 30 additions and 30 deletions

View File

@ -1,7 +1,7 @@
TinyXML-2 TinyXML-2
========= =========
TinyXML is a simple, small, efficient, C++ XML parser that can be TinyXML-2 is a simple, small, efficient, C++ XML parser that can be
easily integrated into other programs. easily integrated into other programs.
The master is hosted on github: The master is hosted on github:
@ -15,7 +15,7 @@ Examples are in the "related pages" tab of the HTML docs.
What it does. What it does.
------------- -------------
In brief, TinyXML parses an XML document, and builds from that a In brief, TinyXML-2 parses an XML document, and builds from that a
Document Object Model (DOM) that can be read, modified, and saved. Document Object Model (DOM) that can be read, modified, and saved.
XML stands for "eXtensible Markup Language." It is a general purpose XML stands for "eXtensible Markup Language." It is a general purpose
@ -197,7 +197,7 @@ Or the XMLPrinter class:
Printing to memory is supported by the XMLPrinter. Printing to memory is supported by the XMLPrinter.
XMLPrinter printer; XMLPrinter printer;
doc->Print( &printer ); doc.Print( &printer );
// printer.CStr() has a const char* to the XML // printer.CStr() has a const char* to the XML
#### Print without an XMLDocument #### Print without an XMLDocument

View File

@ -402,7 +402,7 @@ private:
All flavors of Visit methods have a default implementation that returns 'true' (continue All flavors of Visit methods have a default implementation that returns 'true' (continue
visiting). You need to only override methods that are interesting to you. visiting). You need to only override methods that are interesting to you.
Generally Accept() is called on the TiXmlDocument, although all nodes support visiting. Generally Accept() is called on the XMLDocument, although all nodes support visiting.
You should never change the document from a callback. You should never change the document from a callback.
@ -759,12 +759,12 @@ public:
*/ */
virtual bool ShallowEqual( const XMLNode* compare ) const = 0; virtual bool ShallowEqual( const XMLNode* compare ) const = 0;
/** Accept a hierarchical visit of the nodes in the TinyXML DOM. Every node in the /** Accept a hierarchical visit of the nodes in the TinyXML-2 DOM. Every node in the
XML tree will be conditionally visited and the host will be called back XML tree will be conditionally visited and the host will be called back
via the TiXmlVisitor interface. via the XMLVisitor interface.
This is essentially a SAX interface for TinyXML. (Note however it doesn't re-parse This is essentially a SAX interface for TinyXML-2. (Note however it doesn't re-parse
the XML for the callbacks, so the performance of TinyXML is unchanged by using this the XML for the callbacks, so the performance of TinyXML-2 is unchanged by using this
interface versus any other.) interface versus any other.)
The interface has been based on ideas from: The interface has been based on ideas from:
@ -776,7 +776,7 @@ public:
An example of using Accept(): An example of using Accept():
@verbatim @verbatim
TiXmlPrinter printer; XMLPrinter printer;
tinyxmlDoc.Accept( &printer ); tinyxmlDoc.Accept( &printer );
const char* xmlcstr = printer.CStr(); const char* xmlcstr = printer.CStr();
@endverbatim @endverbatim
@ -818,7 +818,7 @@ private:
A text node can have 2 ways to output the next. "normal" output A text node can have 2 ways to output the next. "normal" output
and CDATA. It will default to the mode it was parsed from the XML file and and CDATA. It will default to the mode it was parsed from the XML file and
you generally want to leave it alone, but you can change the output mode with you generally want to leave it alone, but you can change the output mode with
SetCDATA() and query it with CDATA(). SetCData() and query it with CData().
*/ */
class XMLText : public XMLNode class XMLText : public XMLNode
{ {
@ -891,7 +891,7 @@ private:
<?xml version="1.0" standalone="yes"?> <?xml version="1.0" standalone="yes"?>
@endverbatim @endverbatim
TinyXML2 will happily read or write files without a declaration, TinyXML-2 will happily read or write files without a declaration,
however. however.
The text of the declaration isn't interpreted. It is parsed The text of the declaration isn't interpreted. It is parsed
@ -922,12 +922,12 @@ protected:
}; };
/** Any tag that tinyXml doesn't recognize is saved as an /** Any tag that TinyXML-2 doesn't recognize is saved as an
unknown. It is a tag of text, but should not be modified. unknown. It is a tag of text, but should not be modified.
It will be written back to the XML, unchanged, when the file It will be written back to the XML, unchanged, when the file
is saved. is saved.
DTD tags get thrown into TiXmlUnknowns. DTD tags get thrown into XMLUnknowns.
*/ */
class XMLUnknown : public XMLNode class XMLUnknown : public XMLNode
{ {
@ -1005,52 +1005,52 @@ public:
return _next; return _next;
} }
/** IntAttribute interprets the attribute as an integer, and returns the value. /** IntValue interprets the attribute as an integer, and returns the value.
If the value isn't an integer, 0 will be returned. There is no error checking; If the value isn't an integer, 0 will be returned. There is no error checking;
use QueryIntAttribute() if you need error checking. use QueryIntValue() if you need error checking.
*/ */
int IntValue() const { int IntValue() const {
int i=0; int i=0;
QueryIntValue( &i ); QueryIntValue( &i );
return i; return i;
} }
/// Query as an unsigned integer. See IntAttribute() /// Query as an unsigned integer. See IntValue()
unsigned UnsignedValue() const { unsigned UnsignedValue() const {
unsigned i=0; unsigned i=0;
QueryUnsignedValue( &i ); QueryUnsignedValue( &i );
return i; return i;
} }
/// Query as a boolean. See IntAttribute() /// Query as a boolean. See IntValue()
bool BoolValue() const { bool BoolValue() const {
bool b=false; bool b=false;
QueryBoolValue( &b ); QueryBoolValue( &b );
return b; return b;
} }
/// Query as a double. See IntAttribute() /// Query as a double. See IntValue()
double DoubleValue() const { double DoubleValue() const {
double d=0; double d=0;
QueryDoubleValue( &d ); QueryDoubleValue( &d );
return d; return d;
} }
/// Query as a float. See IntAttribute() /// Query as a float. See IntValue()
float FloatValue() const { float FloatValue() const {
float f=0; float f=0;
QueryFloatValue( &f ); QueryFloatValue( &f );
return f; return f;
} }
/** QueryIntAttribute interprets the attribute as an integer, and returns the value /** QueryIntValue interprets the attribute as an integer, and returns the value
in the provided parameter. The function will return XML_NO_ERROR on success, in the provided parameter. The function will return XML_NO_ERROR on success,
and XML_WRONG_ATTRIBUTE_TYPE if the conversion is not successful. and XML_WRONG_ATTRIBUTE_TYPE if the conversion is not successful.
*/ */
XMLError QueryIntValue( int* value ) const; XMLError QueryIntValue( int* value ) const;
/// See QueryIntAttribute /// See QueryIntValue
XMLError QueryUnsignedValue( unsigned int* value ) const; XMLError QueryUnsignedValue( unsigned int* value ) const;
/// See QueryIntAttribute /// See QueryIntValue
XMLError QueryBoolValue( bool* value ) const; XMLError QueryBoolValue( bool* value ) const;
/// See QueryIntAttribute /// See QueryIntValue
XMLError QueryDoubleValue( double* value ) const; XMLError QueryDoubleValue( double* value ) const;
/// See QueryIntAttribute /// See QueryIntValue
XMLError QueryFloatValue( float* value ) const; XMLError QueryFloatValue( float* value ) const;
/// Set the attribute to a string value. /// Set the attribute to a string value.
@ -1301,10 +1301,10 @@ public:
const XMLAttribute* FindAttribute( const char* name ) const; const XMLAttribute* FindAttribute( const char* name ) const;
/** Convenience function for easy access to the text inside an element. Although easy /** Convenience function for easy access to the text inside an element. Although easy
and concise, GetText() is limited compared to getting the TiXmlText child and concise, GetText() is limited compared to getting the XMLText child
and accessing it directly. and accessing it directly.
If the first child of 'this' is a TiXmlText, the GetText() If the first child of 'this' is a XMLText, the GetText()
returns the character string of the Text node, else null is returned. returns the character string of the Text node, else null is returned.
This is a convenient method for getting the text of simple contained text: This is a convenient method for getting the text of simple contained text:
@ -1431,7 +1431,7 @@ public:
You may optionally pass in the 'nBytes', which is You may optionally pass in the 'nBytes', which is
the number of bytes which will be parsed. If not the number of bytes which will be parsed. If not
specified, TinyXML will assume 'xml' points to a specified, TinyXML-2 will assume 'xml' points to a
null terminated string. null terminated string.
*/ */
XMLError Parse( const char* xml, size_t nBytes=(size_t)(-1) ); XMLError Parse( const char* xml, size_t nBytes=(size_t)(-1) );
@ -1507,7 +1507,7 @@ public:
Or you can use a printer to print to memory: Or you can use a printer to print to memory:
@verbatim @verbatim
XMLPrinter printer; XMLPrinter printer;
doc->Print( &printer ); doc.Print( &printer );
// printer.CStr() has a const char* to the XML // printer.CStr() has a const char* to the XML
@endverbatim @endverbatim
*/ */
@ -1614,7 +1614,7 @@ private:
/** /**
A XMLHandle is a class that wraps a node pointer with null checks; this is A XMLHandle is a class that wraps a node pointer with null checks; this is
an incredibly useful thing. Note that XMLHandle is not part of the TinyXML an incredibly useful thing. Note that XMLHandle is not part of the TinyXML-2
DOM structure. It is a separate utility class. DOM structure. It is a separate utility class.
Take an example: Take an example:
@ -1829,7 +1829,7 @@ private:
@verbatim @verbatim
XMLPrinter printer; XMLPrinter printer;
doc->Print( &printer ); doc.Print( &printer );
SomeFunction( printer.CStr() ); SomeFunction( printer.CStr() );
@endverbatim @endverbatim