Method UpdateAgentList

Core/ClientSML/src/sml_ClientKernel.cpp:883–920

* @brief Get the list of agents currently active in the kernel * and create local Agent objects for each one (if we * don't already have that agent registered). *************************************************************/

*        don't already have that agent registered).
*************************************************************/
void Kernel::UpdateAgentList()
{
    AnalyzeXML response ;
    if (GetConnection()->SendAgentCommand(&response, sml_Names::kCommand_GetAgentList))
    {
        ElementXML const* pResult = response.GetResultTag() ;
        ElementXML child(NULL) ;
        
        // Keep a record of the agents we find, so we can delete any that have been removed.
        std::list<Agent*>   inUse ;
        
        for (int i = 0 ; i < pResult->GetNumberChildren() ; i++)
        {
            pResult->GetChild(&child, i) ;
            
            // Look for the <name> tags
            if (child.IsTag(sml_Names::kTagName))
            {
                // Get the agent's name
                char const* pAgentName = child.GetCharacterData() ;
                
                // If we don't know about this agent already, then add it to our list.
                Agent* pAgent = m_AgentMap.find(pAgentName) ;
                
                if (!pAgent)
                {
                    pAgent = MakeAgent(pAgentName) ;
                }
                
                inUse.push_back(pAgent) ;
            }
        }
        
        // Any agents that are in our map but not in the "inuse" list we should delete
        // as they no longer exist.
        m_AgentMap.keep(&inUse) ;
    }
}

/*************************************************************
* @brief Ask the kernel for the current list of connections