2.1.26.32 tree_find_node_by_dataID

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include
9 Reference

Description

Finds a tree node given its data id, and optionally its parent data id and repeat id, and granparent data id and repeat id.

Syntax

TreeNode tree_find_node_by_dataID( TreeNode tr, int nID, int nIDParent = 0, int nParentRepeatID = -1, int nIDGrandParent = 0, int nGrandParentRepeatID = -1 )

Parameters

tr: [input] the tree to search
nID: [input] the data id to find
nIDParent: [input] optional parent data id
nParentRepeatID: [input] optional parent repeat id
nIDGrandParent: [input] optional grandparent data id
nGrandParentRepeatID: [input] optional grandparent repeat id

Return

the TreeNode found if successful, an invalid TreeNode if not found.

Examples

EX1

void tree_find_node_by_dataID_ex1()
{
	Tree trTest;
	TreeNode tn1, tn2;
	tn1 = trTest.AddTextNode("node 1", "Node1");
	tn1.SetAttribute(STR_DATAID_ATTRIB, 1);
	tn1.SetAttribute(STR_REPEAT_ID_ATTRIB, 1);
	tn2 = trTest.AddTextNode("node 2", "Node2");
	tn2.SetAttribute(STR_DATAID_ATTRIB, 2);
	tn2.SetAttribute(STR_REPEAT_ID_ATTRIB, 2);
	TreeNode tn1_1, tn1_2;
	tn1_1 = tn1.AddTextNode("node 1.1", "Node1.1");
	tn1_1.SetAttribute(STR_DATAID_ATTRIB, 3);
	tn1_1.SetAttribute(STR_REPEAT_ID_ATTRIB, 3);
	tn1_2 = tn1.AddTextNode("node 1.2", "Node1.2");
	tn1_2.SetAttribute(STR_DATAID_ATTRIB, 4);
	tn1_2.SetAttribute(STR_REPEAT_ID_ATTRIB, 4);
	TreeNode tn1_1_1, tn1_1_2;
	tn1_1_1 = tn1_1.AddTextNode("node 1.1.1", "Node1.1.1");
	tn1_1_1.SetAttribute(STR_DATAID_ATTRIB, 5);
	tn1_1_1.SetAttribute(STR_REPEAT_ID_ATTRIB, 5);
	tn1_1_2 = tn1_1.AddTextNode("node 1.1.2", "Node1.1.2");
	tn1_1_2.SetAttribute(STR_DATAID_ATTRIB, 6);
	tn1_1_2.SetAttribute(STR_REPEAT_ID_ATTRIB, 6);
	
	TreeNode tnRet;
	
	tnRet = tree_find_node_by_dataID(trTest, 1, 0, -1, 0, -1);
	if( tnRet )
		out_str(tnRet.tagName);
	else
		out_str("can't find");
	
	tnRet = tree_find_node_by_dataID(trTest, 7, 0, -1, 0, -1);
	if( tnRet )
		out_str(tnRet.tagName);
	else
		out_str("can't find");
	
	tnRet = tree_find_node_by_dataID(trTest, 5, 3, -1, 1, -1);
	if( tnRet )
		out_str(tnRet.tagName);
	else
		out_str("can't find");
}