Method CreateEmbeddedConnection

Core/ClientSML/src/sml_ClientKernel.cpp:749–777

* @brief Creates a connection to the Soar kernel that is embedded * within the same process as the caller. * (This method is protected - clients should use the two methods above that are more explicitly named). * * @param ClientThread If true, Soar will run in the client's thread and the client must periodically call over to the * kernel to check for incoming

*          If an error occurs a Kernel object is still returned.  Call "HadError()" and "GetLastErrorDescription()" on it.
*************************************************************/
Kernel* Kernel::CreateEmbeddedConnection(bool clientThread, bool optimized, int portToListenOn)
{
    ErrorCode errorCode = 0 ;
    
    /* -- Create Soar_Instance and Output_Manager singletons -- */
    Soar_Instance* lSoarInstance = instantiate_singletons();
    Connection* pConnection = Connection::CreateEmbeddedConnection(clientThread, optimized, portToListenOn, &errorCode) ;
    
    // Even if pConnection is NULL, we still build a kernel object, so we have
    // a clean way to pass the error code back to the caller.
    Kernel* pKernel = new Kernel(pConnection) ;
    
    // Transfer any errors over to the kernel object, so the caller can retrieve them.
    pKernel->SetError(errorCode) ;
    
    // Register for "calls" from the kernel.
    if (pConnection)
    {
        lSoarInstance->init_Soar_Instance(pKernel);
        
        pConnection->RegisterCallback(ReceivedCall, pKernel, sml_Names::kDocType_Call, true) ;
        
        pKernel->InitializeTimeTagCounter() ;
        
        pKernel->InitEvents() ;
    }
    
    return pKernel ;
}

int Kernel::GetListenerPort()
{