Method ParseDeep

src/util/tinyxml2/tinyxml2.cpp:988–1086

	char* XMLNode::ParseDeep(char* p, StrPair* parentEndTag, int* curLineNumPtr)
	{
		// This is a recursive method, but thinking about it "at the current level"
		// it is a pretty simple flat list:
		//		<foo/>
		//		<!-- comment -->
		//
		// With a special case:
		//		<foo>
		//		</foo>
		//		<!-- comment -->
		//
		// Where the closing element (/foo) *must* be the next thing after the opening
		// element, and the names must match. BUT the tricky bit is that the closing
		// element will be read by the child.
		//
		// 'endTag' is the end tag for this node, it is returned by a call to a child.
		// 'parentEnd' is the end tag for the parent, which is filled in and returned.

		while (p && *p) {
			XMLNode* node = 0;

			p = _document->Identify(p, &node);
			TIXMLASSERT(p);
			if (node == 0) {
				break;
			}

			int initialLineNum = node->_parseLineNum;

			StrPair endTag;
			p = node->ParseDeep(p, &endTag, curLineNumPtr);
			if (!p) {
				DeleteNode(node);
				if (!_document->Error()) {
					_document->SetError(XML_ERROR_PARSING, 0, 0, initialLineNum);
				}
				break;
			}

			XMLDeclaration* decl = node->ToDeclaration();
			if (decl) {
				// Declarations are only allowed at document level
				bool wellLocated = (ToDocument() != 0);
				if (wellLocated) {
					// Multiple declarations are allowed but all declarations
					// must occur before anything else
					for (const XMLNode* existingNode = _document->FirstChild(); existingNode; existingNode = existingNode->NextSibling()) {
						if (!existingNode->ToDeclaration()) {
							wellLocated = false;
							break;
						}
					}
				}
				if (!wellLocated) {
					_document->SetError(XML_ERROR_PARSING_DECLARATION, decl->Value(), 0, initialLineNum);
					DeleteNode(node);
					break;