Method ReceivedRhsEvent

Core/ClientSML/src/sml_ClientKernel.cpp:658–705

* @brief This function is called when an event is received * from the Soar kernel. * * @param pIncoming The event command * @param pResponse The reply (the result of executing this rhs function) *************************************************************/

* @param pResponse  The reply (the result of executing this rhs function)
*************************************************************/
void Kernel::ReceivedRhsEvent(smlRhsEventId id, AnalyzeXML* pIncoming, ElementXML* pResponse)
{
    // Get the function name and the argument to the function
    // (We pass a single string but it could be parsed further to other values by the client)
    char const* pFunctionName = pIncoming->GetArgString(sml_Names::kParamFunction) ;
    char const* pArgument     = pIncoming->GetArgString(sml_Names::kParamValue) ;
    char const* pAgentName    = pIncoming->GetArgString(sml_Names::kParamName) ;
    
    if (!pFunctionName)
    {
        // Should always include a function name
        SetError(Error::kInvalidArgument) ;
        return ;
    }
    
    // Look up the handler(s) from the map
    RhsEventMap::ValueList* pHandlers = m_RhsEventMap.getList(pFunctionName) ;
    
    if (!pHandlers)
    {
        return ;
    }
    
    // Look up the agent
    Agent* pAgent = pAgentName ? GetAgent(pAgentName) : NULL ;
    
    // Go through the list of event handlers calling each in turn...except
    // we only execute the first handler (registering multipler handlers for the same RHS function is not supported
    // because these functions return a value -- it wouldn't be clear which to use.  We could change this to call all
    // registered handlers and only use the first or last value returned.)
    RhsEventMap::ValueListIter iter = pHandlers->begin() ;
    
    if (iter == pHandlers->end())
    {
        return ;
    }
    
    RhsEventHandlerPlusData handlerWithData = *iter ;
    
    RhsEventHandler handler = handlerWithData.m_Handler ;
    void* pUserData = handlerWithData.getUserData() ;
    
    // Call the handler
    std::string result = handler(id, pUserData, pAgent, pFunctionName, pArgument) ;
    
    // If we got back a result then fill in the value in the response message.
    GetConnection()->AddSimpleResultToSMLResponse(pResponse, result.c_str()) ;
}

Kernel* Kernel::CreateKernelInCurrentThread(bool optimized, int portToListenOn)
{