???_WOSD functions.

Detailed Description

The strings given as parameters for the "add" and "update" methods that have a name with the postfix "_WOSD" (that means "WithOut String Duplication")(for example "addText_WOSD") will be free'd by the XMLNode class.

For example, it means that this is incorrect:

xNode.addText_WOSD("foo");
xNode.updateAttribute_WOSD("#newcolor" ,NULL,"color");

In opposition, this is correct:

xNode.addText("foo");
xNode.addText_WOSD(stringDup("foo"));
xNode.updateAttribute("#newcolor" ,NULL,"color");
xNode.updateAttribute_WOSD(stringDup("#newcolor"),NULL,"color");

Typically, you will never do:

char *b=(char*)malloc(...);
xNode.addText(b);
free(b);

... but rather:

char *b=(char*)malloc(...);
xNode.addText_WOSD(b);

('free(b)' is performed by the XMLNode class)

Collaboration diagram for ???_WOSD functions.:

Functions
static XMLNode	XMLNode::createXMLTopNode_WOSD (XMLSTR lpszName, char isDeclaration=FALSE)
	Create the top node of an XMLNode structure. More...
XMLNode	XMLNode::addChild_WOSD (XMLSTR lpszName, char isDeclaration=FALSE, XMLElementPosition pos=-1)
	Add a new child node. More...
XMLAttribute *	XMLNode::addAttribute_WOSD (XMLSTR lpszName, XMLSTR lpszValue)
	Add a new attribute. More...
XMLCSTR	XMLNode::addText_WOSD (XMLSTR lpszValue, XMLElementPosition pos=-1)
	Add a new text content. More...
XMLClear *	XMLNode::addClear_WOSD (XMLSTR lpszValue, XMLCSTR lpszOpen=NULL, XMLCSTR lpszClose=NULL, XMLElementPosition pos=-1)
	Add a new clear Tag. More...
XMLCSTR	XMLNode::updateName_WOSD (XMLSTR lpszName)
	change node's name More...
XMLAttribute *	XMLNode::updateAttribute_WOSD (XMLAttribute *newAttribute, XMLAttribute *oldAttribute)
	if the attribute to update is missing, a new one will be added More...
XMLAttribute *	XMLNode::updateAttribute_WOSD (XMLSTR lpszNewValue, XMLSTR lpszNewName=NULL, int i=0)
	if the attribute to update is missing, a new one will be added More...
XMLAttribute *	XMLNode::updateAttribute_WOSD (XMLSTR lpszNewValue, XMLSTR lpszNewName, XMLCSTR lpszOldName)
	set lpszNewName=NULL if you don't want to change the name of the attribute if the attribute to update is missing, a new one will be added More...
XMLCSTR	XMLNode::updateText_WOSD (XMLSTR lpszNewValue, int i=0)
	if the text to update is missing, a new one will be added More...
XMLCSTR	XMLNode::updateText_WOSD (XMLSTR lpszNewValue, XMLCSTR lpszOldValue)
	if the text to update is missing, a new one will be added More...
XMLClear *	XMLNode::updateClear_WOSD (XMLSTR lpszNewContent, int i=0)
	if the clearTag to update is missing, a new one will be added More...
XMLClear *	XMLNode::updateClear_WOSD (XMLClear *newP, XMLClear *oldP)
	if the clearTag to update is missing, a new one will be added More...
XMLClear *	XMLNode::updateClear_WOSD (XMLSTR lpszNewValue, XMLCSTR lpszOldValue)
	if the clearTag to update is missing, a new one will be added More...

Function Documentation

addAttribute_WOSD()

XMLAttribute * XMLNode::addAttribute_WOSD	(	XMLSTR	lpszName,
		XMLSTR	lpszValue
	)

Add a new attribute.

Definition at line 2547 of file xmlParser.cpp.

References XMLNode::addAttribute_priv().

Referenced by XMLNode::updateAttribute_WOSD().

addChild_WOSD()

XMLNode XMLNode::addChild_WOSD	(	XMLSTR	lpszName,
		char	isDeclaration = FALSE,
		XMLElementPosition	pos = -1
	)

Add a new child node.

Definition at line 2543 of file xmlParser.cpp.

References XMLNode::addChild_priv(), and XMLNode::isDeclaration().

addClear_WOSD()

XMLClear * XMLNode::addClear_WOSD	(	XMLSTR	lpszValue,
		XMLCSTR	lpszOpen = NULL,
		XMLCSTR	lpszClose = NULL,
		XMLElementPosition	pos = -1
	)

Add a new clear Tag.

Definition at line 2555 of file xmlParser.cpp.

References XMLNode::addClear_priv().

Referenced by XMLNode::updateClear_WOSD().

addText_WOSD()

XMLCSTR XMLNode::addText_WOSD	(	XMLSTR	lpszValue,
		XMLElementPosition	pos = -1
	)

Add a new text content.

Definition at line 2551 of file xmlParser.cpp.

References XMLNode::addText_priv().

Referenced by XMLNode::updateText_WOSD().

createXMLTopNode_WOSD()

XMLNode XMLNode::createXMLTopNode_WOSD ( XMLSTR  lpszName, char  isDeclaration = FALSE  )

static

Create the top node of an XMLNode structure.

Definition at line 1000 of file xmlParser.cpp.

References XMLNode::isDeclaration(), and XMLNode::XMLNode().

updateAttribute_WOSD() [1/3]

XMLAttribute * XMLNode::updateAttribute_WOSD	(	XMLAttribute *	newAttribute,
		XMLAttribute *	oldAttribute
	)

if the attribute to update is missing, a new one will be added

Definition at line 2226 of file xmlParser.cpp.

References XMLNode::addAttribute_WOSD(), XMLAttribute::lpszName, XMLAttribute::lpszValue, and XMLSTR.

Referenced by XMLNode::updateAttribute(), and XMLNode::updateAttribute_WOSD().

updateAttribute_WOSD() [2/3]

XMLAttribute * XMLNode::updateAttribute_WOSD	(	XMLSTR	lpszNewValue,
		XMLSTR	lpszNewName = NULL,
		int	i = 0
	)

if the attribute to update is missing, a new one will be added

Definition at line 2211 of file xmlParser.cpp.

References XMLNode::addAttribute_WOSD(), and XMLNode::d.

updateAttribute_WOSD() [3/3]

XMLAttribute * XMLNode::updateAttribute_WOSD	(	XMLSTR	lpszNewValue,
		XMLSTR	lpszNewName,
		XMLCSTR	lpszOldName
	)

set lpszNewName=NULL if you don't want to change the name of the attribute if the attribute to update is missing, a new one will be added

Definition at line 2232 of file xmlParser.cpp.

References XMLNode::addAttribute_WOSD(), XMLNode::getAttribute(), stringDup(), and XMLNode::updateAttribute_WOSD().

updateClear_WOSD() [1/3]

XMLClear * XMLNode::updateClear_WOSD	(	XMLSTR	lpszNewContent,
		int	i = 0
	)

if the clearTag to update is missing, a new one will be added

Definition at line 2306 of file xmlParser.cpp.

References XMLNode::addClear_WOSD(), and XMLNode::d.

Referenced by XMLNode::updateClear(), and XMLNode::updateClear_WOSD().

updateClear_WOSD() [2/3]

XMLClear * XMLNode::updateClear_WOSD	(	XMLClear *	newP,
		XMLClear *	oldP
	)

if the clearTag to update is missing, a new one will be added

Definition at line 2323 of file xmlParser.cpp.

References XMLClear::lpszValue, XMLNode::updateClear_WOSD(), and XMLSTR.

updateClear_WOSD() [3/3]

XMLClear * XMLNode::updateClear_WOSD	(	XMLSTR	lpszNewValue,
		XMLCSTR	lpszOldValue
	)

if the clearTag to update is missing, a new one will be added

Definition at line 2315 of file xmlParser.cpp.

References XMLNode::addClear_WOSD(), XMLNode::d, XMLNode::indexClear(), and XMLNode::updateClear_WOSD().

updateName_WOSD()

XMLCSTR XMLNode::updateName_WOSD

(

XMLSTR

lpszName

)

change node's name

Definition at line 967 of file xmlParser.cpp.

References XMLNode::d.

Referenced by XMLNode::updateName().

updateText_WOSD() [1/2]

XMLCSTR XMLNode::updateText_WOSD	(	XMLSTR	lpszNewValue,
		int	i = 0
	)

if the text to update is missing, a new one will be added

Definition at line 2266 of file xmlParser.cpp.

References XMLNode::addText_WOSD(), XMLNode::d, and XMLCSTR.

Referenced by XMLNode::updateText(), and XMLNode::updateText_WOSD().

updateText_WOSD() [2/2]

XMLCSTR XMLNode::updateText_WOSD	(	XMLSTR	lpszNewValue,
		XMLCSTR	lpszOldValue
	)

if the text to update is missing, a new one will be added

Definition at line 2275 of file xmlParser.cpp.

References XMLNode::addText_WOSD(), XMLNode::d, XMLNode::indexText(), and XMLNode::updateText_WOSD().