Method ReceivedAgentEvent

Core/ClientSML/src/sml_ClientKernel.cpp:614–649

* @brief This function is called when an event is received * from the Soar kernel. * * @param pIncoming The event command * @param pResponse The reply (no real need to fill anything in here currently) *************************************************************/

* @param pResponse  The reply (no real need to fill anything in here currently)
*************************************************************/
void Kernel::ReceivedAgentEvent(smlAgentEventId id, AnalyzeXML* pIncoming, ElementXML* /*pResponse*/)
{
    // Get the name of the agent this event refers to.
    char const* pAgentName = pIncoming->GetArgString(sml_Names::kParamName) ;
    
    // Look up the handler(s) from the map
    AgentEventMap::ValueList* pHandlers = m_AgentEventMap.getList(id) ;
    
    if (!pHandlers)
    {
        return ;
    }
    
    // See if we already have an Agent* for this agent.
    // We may not, because "agent created" events are included in the list that come here.
    Agent* pAgent = GetAgent(pAgentName) ;
    
    // Agent name can be null for some agent manager events
    if (!pAgent && pAgentName)
    {
        // Create a new client side agent object
        // We have to do this now because we'll be passing it back to the caller in a minute
        pAgent = MakeAgent(pAgentName) ;
    }
    
    // Go through the list of event handlers calling each in turn
    for (AgentEventMap::ValueListIter iter = pHandlers->begin() ; iter != pHandlers->end() ; iter++)
    {
        AgentEventHandlerPlusData handlerPlus = *iter ;
        AgentEventHandler handler = handlerPlus.m_Handler ;
        void* pUserData = handlerPlus.getUserData() ;
        
        // Call the handler
        handler(id, pUserData, pAgent) ;
    }
}

/*************************************************************
* @brief This function is called when an event is received