Method CreateStringWME

Core/ClientSML/src/sml_ClientWorkingMemory.cpp:838–868

* @brief Builds a new WME that has a string value and schedules * it for addition to Soar's input link. * * The agent retains ownership of this object. * The returned object is valid until the caller * deletes the parent identifier. * The WME is not added to Soar's input link until the * client calls "Commit". **********************************************

*        client calls "Commit".
*************************************************************/
StringElement* WorkingMemory::CreateStringWME(Identifier* parent, char const* pAttribute, char const* pValue)
{
    assert(m_Agent == parent->GetAgent()) ;
    
    StringElement* pWME = new StringElement(GetAgent(), parent, parent->GetValueAsString(), pAttribute, pValue, GenerateTimeTag()) ;
    
    // Record that the identifer owns this new WME
    parent->AddChild(pWME) ;
    
#ifdef SML_DIRECT
    if (GetConnection()->IsDirectConnection())
    {
        EmbeddedConnection* pConnection = static_cast<EmbeddedConnection*>(GetConnection());
        pConnection->DirectAddWME_String(m_AgentSMLHandle, parent->GetValueAsString(), pAttribute, pValue, pWME->GetTimeTag());
        
        // Return immediately, without adding it to the commit list.
        return pWME ;
    }
#endif
    
    // Add it to our list of changes that need to be sent to Soar.
    m_DeltaList.AddWME(pWME) ;
    
    // Commit immediately if we're configured that way (makes life simpler for the client)
    if (IsAutoCommitEnabled())
    {
        Commit() ;
    }
    
    return pWME ;
}

/*************************************************************
* @brief Same as CreateStringWME but for a new WME that has