sc_object_manager.h

/*****************************************************************************

  Licensed to Accellera Systems Initiative Inc. (Accellera) under one or
  more contributor license agreements.  See the NOTICE file distributed
  with this work for additional information regarding copyright ownership.
  Accellera licenses this file to you under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with the
  License.  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
  implied.  See the License for the specific language governing
  permissions and limitations under the License.

 *****************************************************************************/

/*****************************************************************************

  sc_object_manager.h -- Manager of objects (naming, &c.)

  Original Author: Stan Y. Liao, Synopsys, Inc.

  CHANGE LOG AT THE END OF THE FILE
 *****************************************************************************/


#ifndef SC_OBJECT_MANAGER_H
#define SC_OBJECT_MANAGER_H

#include <map>
#include <vector>

namespace sc_core {

class sc_event;
class sc_object;
class sc_module_name;


// ----------------------------------------------------------------------------
//  CLASS : sc_object_manager
//
//  Manager of objects.
// ----------------------------------------------------------------------------

class sc_object_manager
{
    friend class sc_event;
    friend class sc_object;
    friend class sc_simcontext;

protected:
    enum sc_name_origin
    {
        SC_NAME_NONE,
        SC_NAME_OBJECT,
        SC_NAME_EVENT,
        SC_NAME_EXTERNAL
    };

    struct table_entry
    {
        table_entry() : m_element_p(NULL), m_name_origin(SC_NAME_NONE) {}

	    void*          m_element_p; // can be an sc_object or an sc_event
        sc_name_origin m_name_origin;
    };

public:
    typedef std::map<std::string,table_entry> instance_table_t;
    typedef std::vector<sc_object_host*>      object_vector_t;

    sc_object_manager();
    ~sc_object_manager();

    bool name_exists(const std::string& name);
    const char* get_name(const std::string& name);

    sc_event* find_event(const char* name);

    sc_object* find_object(const char* name);
    sc_object* first_object();
    sc_object* next_object();

    void hierarchy_push(sc_object_host* mdl);
    sc_object_host* hierarchy_pop();
    sc_object_host* hierarchy_curr();
    int hierarchy_size();

    void push_module_name(sc_module_name* mod_name);
    sc_module_name* pop_module_name();
    sc_module_name* top_of_module_name_stack() const;
    const char*     top_of_module_name_stack_name() const;

private:
    std::string create_name( const char* leaf_name );
    void insert_event(const std::string& name, sc_event* obj);
    void insert_object(const std::string& name, sc_object* obj);
    bool insert_external_name(const std::string& name);
    void remove_event(const std::string& name);
    void remove_object(const std::string& name);
    bool remove_external_name(const std::string& name);

private:

    instance_table_t::iterator m_event_it;          // event instance iterator.
    bool                       m_event_walk_ok;     // true if can walk events.
    instance_table_t           m_instance_table;    // table of instances.
    sc_module_name*            m_module_name_stack; // sc_module_name stack.
    instance_table_t::iterator m_object_it;         // object instance iterator.
    object_vector_t            m_object_stack;      // sc_object stack.
    bool                       m_object_walk_ok;    // true if can walk objects.
};

} // namespace sc_core

// $Log: sc_object_manager.h,v $
// Revision 1.9  2011/08/26 20:46:10  acg
//  Andy Goodrich: moved the modification log to the end of the file to
//  eliminate source line number skew when check-ins are done.
//
// Revision 1.8  2011/03/06 15:55:11  acg
//  Andy Goodrich: Changes for named events.
//
// Revision 1.7  2011/03/05 19:44:20  acg
//  Andy Goodrich: changes for object and event naming and structures.
//
// Revision 1.6  2011/03/05 01:39:21  acg
//  Andy Goodrich: changes for named events.
//
// Revision 1.5  2011/02/18 20:27:14  acg
//  Andy Goodrich: Updated Copyrights.
//
// Revision 1.4  2011/02/13 21:47:37  acg
//  Andy Goodrich: update copyright notice.
//
// Revision 1.3  2010/07/22 20:02:33  acg
//  Andy Goodrich: bug fixes.
//
// Revision 1.2  2008/05/22 17:06:26  acg
//  Andy Goodrich: updated copyright notice to include 2008.
//
// Revision 1.1.1.1  2006/12/15 20:20:05  acg
// SystemC 2.3
//
// Revision 1.3  2006/01/13 18:44:30  acg
// Added $Log to record CVS changes into the source.

#endif