Method TryToAttachOrphanedChildren

Core/ClientSML/src/sml_ClientWorkingMemory.cpp:390–425

* @brief Some output WMEs will come to us "out of order". * That's to say, a child of an identifier appears before * the identifier (e.g. (X ^name me) before (Y ^person X)). * This function searches the list of wmes that haven't been * attached to an identifier yet and attaches them together * (if the identifier strings match). * By the end of a single out

* @param pPossibleParent    The identifier that may have orphaned children to attach.
*************************************************************/
bool WorkingMemory::TryToAttachOrphanedChildren(Identifier* pPossibleParent)
{
    if (m_OutputOrphans.empty())
    {
        return false ;
    }
    
    bool deleteFromList = true ;
    WMElement* pWme = SearchWmeListForID(&m_OutputOrphans, pPossibleParent->GetValueAsString(), deleteFromList) ;
    
    while (pWme)
    {
        assert(pWme->m_ID == NULL) ;
        assert(pWme->m_IDName.compare(pPossibleParent->GetValueAsString()) == 0) ;
        pWme->SetSymbol(pPossibleParent->GetSymbol());
        pPossibleParent->AddChild(pWme) ;
        
        if (this->GetAgent()->GetKernel()->IsTracingCommunications())
        {
            sml::PrintDebugFormat("Adding orphaned child to this ID: %s ^%s %s (time tag %d)", pWme->GetIdentifierName(), pWme->GetAttribute(), pWme->GetValueAsString(), pWme->GetTimeTag()) ;
        }
        
        // If the wme being attached is itself an identifier, we have to check in turn to see if it has any orphaned children
        if (pWme->IsIdentifier())
        {
            TryToAttachOrphanedChildren(pWme->ConvertToIdentifier()) ;
        }
        
        // Make a record that this wme was added so we can alert the client to this change.
        RecordAddition(pWme) ;
        
        pWme = SearchWmeListForID(&m_OutputOrphans, pPossibleParent->GetValueAsString(), deleteFromList) ;
    }
    
    return true ;
}

/*************************************************************
* @brief This function is called when an output wme has been removed.