Method UpdateString

Core/ClientSML/src/sml_ClientWorkingMemory.cpp:947–997

* @brief Update the value of an existing WME. * The value is not actually sent to the kernel * until "Commit" is called. *************************************************************/

*        until "Commit" is called.
*************************************************************/
void WorkingMemory::UpdateString(StringElement* pWME, char const* pValue)
{
    if (!pWME || !pValue)
    {
        return ;
    }
    
    assert(m_Agent == pWME->GetAgent()) ;
    
    // If the value hasn't changed and we're set to not blink the wme (remove/add it again)
    // then there's no work to do.
    if (!m_Agent->IsBlinkIfNoChange())
    {
        if (strcmp(pWME->GetValue(), pValue) == 0)
        {
            return ;
        }
    }
    
    // Changing the value logically is a remove and then an add
    
    // Get the tag of the value to remove
    long long removeTimeTag = pWME->GetTimeTag() ;
    
    // Change the value and the time tag (this is equivalent to us deleting the old object
    // and then creating a new one).
    pWME->SetValue(pValue) ;
    pWME->GenerateNewTimeTag() ;
    
#ifdef SML_DIRECT
    if (GetConnection()->IsDirectConnection())
    {
        EmbeddedConnection* pConnection = static_cast<EmbeddedConnection*>(GetConnection());
        pConnection->DirectRemoveWME(m_AgentSMLHandle, removeTimeTag);
        
        pConnection->DirectAddWME_String(m_AgentSMLHandle, pWME->GetIdentifierName(), pWME->GetAttribute(), pValue, pWME->GetTimeTag());
        
        // Return immediately, without adding it to the commit list.
        return ;
    }
#endif
    
    // Add it to the list of changes that need to be sent to Soar.
    m_DeltaList.UpdateWME(removeTimeTag, pWME) ;
    
    // Commit immediately if we're configured that way (makes life simpler for the client)
    if (IsAutoCommitEnabled())
    {
        Commit() ;
    }
}

void WorkingMemory::UpdateInt(IntElement* pWME, long long value)
{