Represents an EDIF Net. More...

#include <Net.hpp>

Inheritance diagram for torc::generic::Net:

Collaboration diagram for torc::generic::Net:

Public Types
typedef std::list < NetSharedPtr >::iterator	Connection

typedef boost::signals2::signal< void(const NetSharedPtr &)>	Connected

typedef boost::signals2::signal< void(const NetSharedPtr &)>	Disconnected

typedef std::string	Name

typedef Net	Type

typedef boost::shared_ptr< Type >	Pointer

typedef boost::weak_ptr< Type >	WeakPointer

typedef std::vector< Pointer >	List

typedef size_t	SizeType

Public Member Functions
void	addSubnet (const NetSharedPtr &inSubnet) throw (Error)

NetSharedPtr	findSubnet (const std::string &inName) throw (Error)

void	removeSubnet (const std::string &inName) throw (Error)

void	getSubnets (std::vector< NetSharedPtr > &outSubnets) const

void	setSubnets (const std::vector< NetSharedPtr > &inSource) throw (Error)

template<typename _Action >
void	applyOnAllSubnets (const _Action &action) throw (Error)

NetSharedPtr	getParentNet () const

void	setParentNet (const NetSharedPtr &inParent)

const NetAttributesSharedPtr	getAttributes () const

void	setAttributes (const NetAttributesSharedPtr &inSource)

PortSharedPtr	findConnectedPort (const std::string &inName) throw (Error)

virtual void	getConnectedPorts (std::vector< PortSharedPtr > &outPort, bool inSkipChildConnections=false) const

template<typename _Action >
void	applyOnAllConnectedPorts (const _Action &action) throw (Error)

virtual void	getConnectedPortLists (std::vector< PortListSharedPtr > &outPortList) const

template<typename _Action >
void	applyOnAllConnectedPortLists (const _Action &action) throw (Error)

virtual void	disconnect () throw (Error)

PortReferenceSharedPtr	findConnectedPortReference (const std::string &inName) throw (Error)

virtual void	getConnectedPortRefs (std::vector< PortReferenceSharedPtr > &outPortRefs, bool inSkipChildConnections=false) const

template<typename _Action >
void	applyOnAllConnectedPortRefs (const _Action &action) throw (Error)

virtual	~Net () throw ()

void	addComment (const std::string &comment)

const std::vector< std::string > &	getComments () const

void	setComments (const std::vector< std::string > &inSource)

Connected &	signalNetConnected ()

Disconnected &	signalNetDisconnected ()

virtual void	getConnectedNets (std::vector< NetSharedPtr > &outNets, bool inSkipChildConnections=false) const throw (Error)

virtual Connection	connect (const NetSharedPtr &inNet)=0 throw (Error)

virtual void	disconnect (const Connection &inConnection)=0 throw (Error)

void	disconnect (const std::string &inName) throw (Error)

void	disconnect (const NetSharedPtr &net) throw (Error)

virtual const std::string	getName () const

void	setName (const std::string &inSource) throw (Error)

PropertySharedPtr	getProperty (const std::string &inName)

bool	setProperty (const std::string &inName, const PropertySharedPtr &inProperty)

void	getProperties (std::map< std::string, PropertySharedPtr > &outProperties) const

void	setProperties (const std::map< std::string, PropertySharedPtr > &inSource)

template<typename _Action >
void	applyOnAllProperties (const _Action &action) throw (Error)

virtual Name	getOriginalName () const

virtual void	setOriginalName (const Name &inSource)

virtual void	accept (BaseVisitor &inoutVisitor)=0 throw (Error)

virtual CompositionType	getCompositionType () const =0

virtual size_t	getSize () const =0

virtual void	getChildren (List &outChildren) const =0 throw (Error)

virtual const Pointer	get (const std::vector< SizeType > &inIndices) const =0 throw (Error)

virtual void	setParentCollection (const Pointer &inParentCollection)

virtual Pointer	getParentCollection () const

void	setWeakThis (const WeakPointer &inWeakThis)

Pointer	getSharedThis () const

const boost::shared_ptr< View >	getParent () const

virtual void	setParent (const boost::shared_ptr< View > &inSource)

void	getUserData (std::list< std::string > &outUserData) const

void	setUserData (const std::list< std::string > &inSource)

void	addUserData (const std::string &inSource)

Protected Member Functions
void	addConnectedPort (const PortSharedPtr &inPort) throw (Error)

void	removeConnectedPort (const PortSharedPtr &inPort) throw (Error)

void	addConnectedPortList (const PortListSharedPtr &inPort) throw (Error)

void	removeConnectedPortList (const PortListSharedPtr &inList) throw (Error)

void	setConnectedPorts (const std::vector< PortSharedPtr > &inSource) throw (Error)

void	addConnectedPortReference (const PortReferenceSharedPtr &portRef) throw (Error)

void	removeConnectedPortReference (const PortReferenceSharedPtr &inPortRef) throw (Error)

	Net ()

void	setConnectedPortRefs (const std::vector< PortReferenceSharedPtr > &inSource) throw (Error)

virtual void	onConnect () throw (Error)

virtual void	onDisconnect () throw (Error)

Private Member Functions
	Net (const Net &source)

Net &	operator= (const Net &source)

Private Attributes
SymTab< std::string, NetSharedPtr, true >	mSubnets

std::list< PortSharedPtr >	mConnectedPorts

std::list< PortListSharedPtr >	mConnectedPortLists

std::list< PortReferenceSharedPtr >	mConnectedPortRefs

NetSharedPtr	mParentNet

NetAttributesSharedPtr	mAttributes

Friends
class	ConnectionHandler

Detailed Description

Represents an EDIF Net.

The Net class is an interface to EDIF nets. Net is an interface for scalar nets, vector nets, vector nets bits and net bundles. This class provides a simplified view of all three types of nets. To get a handle to an actual net, the client will have to use a Visitor with proper overloads of the visit() function, or dynamic_cast can be used. The latter method is however not recommended. A net object supports storing properties for storing different EDIF properties. See documentation of the Property and PropertyContainer classes for more details.

Definition at line 58 of file generic/Net.hpp.

Member Typedef Documentation

typedef boost::signals2::signal<void(const NetSharedPtr&)> torc::generic::Connectable::Connected

inherited

A signal to indicate that a new connection has been made

Definition at line 57 of file Connectable.hpp.

typedef std::list<NetSharedPtr>::iterator torc::generic::Connectable::Connection

inherited

A connection between a net and this object

Definition at line 52 of file Connectable.hpp.

typedef boost::signals2::signal<void(const NetSharedPtr&)> torc::generic::Connectable::Disconnected

inherited

A signal to indicate that a connection has been removed

Definition at line 62 of file Connectable.hpp.

typedef std::vector<Pointer> torc::generic::Composite< Net >::List

inherited

List of Shared Pointers to objects of type Type

Definition at line 61 of file Composite.hpp.

typedef std::string torc::generic::Renamable::Name

inherited

Definition at line 40 of file generic/Renamable.hpp.

typedef boost::shared_ptr<Type> torc::generic::Composite< Net >::Pointer

inherited

Shared Pointer to object of type Type

Definition at line 55 of file Composite.hpp.

typedef size_t torc::generic::Composite< Net >::SizeType

inherited

Definition at line 62 of file Composite.hpp.

typedef Net torc::generic::Composite< Net >::Type

inherited

Definition at line 50 of file Composite.hpp.

typedef boost::weak_ptr<Type> torc::generic::Composite< Net >::WeakPointer

inherited

Definition at line 56 of file Composite.hpp.

Constructor & Destructor Documentation

torc::generic::Net::Net ( )

protected

Definition at line 43 of file generic/Net.cpp.

          :
     Composite<Net>(), Commentable(), Connectable(), Nameable(), PropertyContainer(), Renamable(), Visitable(), ParentedObject<
         View>(), UserDataContainer(), mSubnets(), mConnectedPorts(), mConnectedPortLists(), mConnectedPortRefs(), mParentNet(), mAttributes() {}

torc::generic::Net::~Net	(	)
throw	(
	)

virtual

Definition at line 47 of file generic/Net.cpp.

                    {
     try {
         disconnect();
     } catch(Error& e) {
         log("Cannot propagate received error\n");
     }
 }

Here is the call graph for this function:

torc::generic::Net::Net ( const Net & source )

private

Member Function Documentation

virtual void torc::generic::Visitable::accept	(	BaseVisitor &	inoutVisitor	)
throw	(	Error
	)

pure virtualinherited

Receive an inoutVisitor to this class. The visit method of the inoutVisitor is called and a reference to this object is passed as a parameter. It has to be noted however, that a dynamic_cast is performed inside this method. If the cast fails, an appropriate exception is thrown by this method. This situation can arise when the passed Visitor object does not inherit from the appropriate inoutVisitor specialization. See Visitor documentation for more details.

Parameters

[in,out] inoutVisitor A reference to the inoutVisitor object

Exceptions

Error Visitor type inappropriate for visiting this object or any other error thrown by the Visitor::throw() method.

Implemented in torc::generic::Root, torc::generic::Permutable, torc::generic::PortBundle, torc::generic::Status, torc::generic::VectorPort, torc::generic::View, torc::generic::InterfaceJoinedInfo, torc::generic::LogicElement, torc::generic::ParameterArray, torc::generic::InstanceArray, torc::generic::Cell, torc::generic::VectorPortReference, torc::generic::VectorNet, torc::generic::Library, torc::generic::LogicValue, torc::generic::Simulate, torc::generic::Property, torc::generic::SingleParameter, torc::generic::Design, torc::generic::SimulationInfo, torc::generic::NetBundle, torc::generic::PortBundleReference, torc::generic::ScalarPort, torc::generic::ScalarNet, torc::generic::ScalarPortReference, torc::generic::SingleInstance, torc::generic::LogicalResponse, torc::generic::InstanceArrayMember, torc::generic::ParameterArrayElement, torc::generic::Event, torc::generic::VectorNetBit, torc::generic::VectorPortBit, torc::generic::Timing, torc::generic::ForbiddenEvent, torc::generic::VectorPortBitReference, and torc::generic::Apply.

void torc::generic::Commentable::addComment ( const std::string & comment )

inherited

Add a comment to the object

Parameters

[in] comment The comment to add to an existing list of comments

Definition at line 36 of file Commentable.cpp.

                                                      {
     mComments.push_back(comment);
 }

void torc::generic::Net::addConnectedPort	(	const PortSharedPtr &	inPort	)
throw	(	Error
	)

protected

Connect a port to this net.

Parameters

[in] inPort port to be added. Empty pointer is ignored.

Exceptions

Error	Could not add Port, because Port name is empty
Error	Could not add Port, because Port name is already exists

Definition at line 147 of file generic/Net.cpp.

                                                                     {
     if(!inPort) {
         return;
     }
     std::string name = inPort->getName();
     if(name.empty()) {
         Error e(eMessageIdErrorEmptyItemName, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("Port name", name);
         throw e;
     }
     mConnectedPorts.push_back(inPort);
     return;
 }

Here is the call graph for this function:

void torc::generic::Net::addConnectedPortList	(	const PortListSharedPtr &	inPort	)
throw	(	Error
	)

protected

Definition at line 218 of file generic/Net.cpp.

                                                                                 {
     if(!inPortList) {
         return;
     }
     mConnectedPortLists.push_back(inPortList);
     return;
 }

void torc::generic::Net::addConnectedPortReference	(	const PortReferenceSharedPtr &	inPortRef	)
throw	(	Error
	)

protected

Connect a port reference to this net.

Parameters

[in] inPortRef Port reference to be added

Exceptions

Error Could not add port reference

Definition at line 247 of file generic/Net.cpp.

                                                                                          {
     if(!inPortRef) {
         return;
     }
     std::string name = inPortRef->getName();
     if(name.empty()) {
         Error e(eMessageIdErrorEmptyItemName, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("PortReference name", name);
         throw e;
     }
     mConnectedPortRefs.push_back(inPortRef);
     return;
 }

Here is the call graph for this function:

void torc::generic::Net::addSubnet	(	const NetSharedPtr &	inSubnet	)
throw	(	Error
	)

Add a subnet to this net.

Parameters

[in] inSubnet Subnet to be added

Exceptions

Error	Could not add subnet, because subnet name is empty Id : eMessageIdErrorEmptyItemName Context Data Subnet name - String
Error	Could not add subnet, because subnet name is already exists Id : eMessageIdErrorItemAlreadyExists Context Data Subnet name - String

Add a subnet to this net.

Parameters

[in] inSubnet Subnet to be added

Exceptions

Error	Could not add subnet, because subnet name is empty
Error	Could not add subnet, because subnet name is already exists

Definition at line 63 of file generic/Net.cpp.

                                                               {
     std::string name = inSubnet->getName();
     if(name.empty()) {
         Error e(eMessageIdErrorEmptyItemName, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("Subnet name", name);
         throw e;
     }
     if(false == mSubnets.set(name, inSubnet)) {
         Error e(eMessageIdErrorItemAlreadyExists, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("Subnet name", name);
         throw e;
     }
     inSubnet->setParentNet(getSharedThis());
     return;
 }

Here is the call graph for this function:

void torc::generic::UserDataContainer::addUserData ( const std::string & inSource )

inherited

Add an user data to the list of user data

Parameters

[in] inSource An user data as string

Definition at line 34 of file UserDataContainer.cpp.

                                                              {
     mUserData.push_back(inSource);
 }

template<typename _Action >

void torc::generic::Net::applyOnAllConnectedPortLists	(	const _Action &	action	)
throw	(	Error
	)

inline

Apply action on all connected port lists.

Parameters

[in] action Action to be applied

Definition at line 317 of file generic/Net.hpp.

                   {
     try {
         std::for_each(mConnectedPortLists.begin(), mConnectedPortLists.end(), action);
     } catch(Error& e) {
         e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
         throw;
     }
 }

Here is the call graph for this function:

template<typename _Action >

void torc::generic::Net::applyOnAllConnectedPortRefs	(	const _Action &	action	)
throw	(	Error
	)

inline

Apply action on all connected port refs.

Parameters

[in] action Action to be applied

Definition at line 327 of file generic/Net.hpp.

                   {
     try {
         std::for_each(mConnectedPortRefs.begin(), mConnectedPortRefs.end(), action);
     } catch(Error& e) {
         e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
         throw;
     }
 }

Here is the call graph for this function:

template<typename _Action >

void torc::generic::Net::applyOnAllConnectedPorts	(	const _Action &	action	)
throw	(	Error
	)

inline

Apply action on all connected ports.

Parameters

[in] action Action to be applied

Definition at line 307 of file generic/Net.hpp.

                   {
     try {
         std::for_each(mConnectedPorts.begin(), mConnectedPorts.end(), action);
     } catch(Error& e) {
         e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
         throw;
     }
 }

Here is the call graph for this function:

template<typename _Action >

void torc::generic::PropertyContainer::applyOnAllProperties	(	const _Action &	action	)
throw	(	Error
	)

inlineinherited

Apply action on all properties.

Parameters

[in] action Action to be applied

Definition at line 113 of file PropertyContainer.hpp.

                                          {
     try {
         mProperties.applyOnAll(action);
     } catch(Error& e) {
         e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
         throw;
     }
 }

Here is the call graph for this function:

template<typename _Action >

void torc::generic::Net::applyOnAllSubnets	(	const _Action &	action	)
throw	(	Error
	)

inline

Apply action on all Subnets.

Parameters

[in] action Action to be applied

Definition at line 284 of file generic/Net.hpp.

                   {
     try {
         mSubnets.applyOnAll(action);
     } catch(Error& e) {
         e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
         throw;
     }
 }

Here is the call graph for this function:

Connectable::Connection torc::generic::Connectable::connect	(	const NetSharedPtr &	inNet	)
throw	(	Error
	)

pure virtualinherited

Connect a Net to this object.

Note: This metod can be overridden by derived classes. However, the method must call the on_connected() method after this. The sigConnected_ signal must also be invoked in the overriding method.

Parameters

[in] inNet A pointer to the Net object that needs to be Connected

Returns: A connection that has been established. This can be used later for disconnection.

Connect a Net to this object.

Note: This metod can be overridden by derived classes. However, the method must call the on_connected() method after this. The sigConnected_ signal must also be invoked in the overriding method.

Parameters

[in] inNet A pointer to the Net object that eeds to be Connected

Returns: A connection that has been established. This can be used later for disconnection.

Implemented in torc::generic::VectorPortReference, torc::generic::PortBundleReference, torc::generic::VectorNet, torc::generic::PortBundle, torc::generic::NetBundle, torc::generic::VectorPort, torc::generic::ScalarPort, torc::generic::ScalarNet, torc::generic::ScalarPortReference, torc::generic::PortList, torc::generic::VectorNetBit, torc::generic::VectorPortBit, and torc::generic::VectorPortBitReference.

Definition at line 60 of file Connectable.cpp.

                                                                                   {
     Connection connection = mConnectedNets.insert(mConnectedNets.end(), inNet);
     try {
         onConnect();
     } catch(Error& e) {
         e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
         throw;
     }
     signalNetConnected()(inNet);
     return connection;
 }

Here is the call graph for this function:

Here is the caller graph for this function:

void torc::generic::Connectable::disconnect	(	const Connection &	inConnection	)
throw	(	Error
	)

pure virtualinherited

Disconnect a Net from this object.

Note: This metod can be overridden by derived classes. However, the method must call the on_connected() method after this. The sigConnected_ signal must also be invoked in the overriding method.

Parameters

[in] inConnection A connection as returned by the connect() method

Exceptions

Error Provided connection is invalid

Implemented in torc::generic::VectorPortReference, torc::generic::PortBundleReference, torc::generic::PortBundle, torc::generic::VectorNet, torc::generic::VectorPort, torc::generic::NetBundle, torc::generic::ScalarPort, torc::generic::ScalarNet, torc::generic::ScalarPortReference, torc::generic::PortList, torc::generic::VectorNetBit, torc::generic::VectorPortBit, and torc::generic::VectorPortBitReference.

Definition at line 83 of file Connectable.cpp.

                                                                                     {
     if(inConnection == mConnectedNets.end()) {
         return;
     }
 
     NetSharedPtr net = *inConnection;
     mConnectedNets.erase(inConnection);
     try {
         onDisconnect();
     } catch(Error& e) {
         e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
         throw;
     }
     signalNetDisconnected()(net);
     return;
 }

Here is the call graph for this function:

void torc::generic::Connectable::disconnect	(	const std::string &	inName	)
throw	(	Error
	)

inherited

Disconnect the named Net from this object.

Note: This metod can be overridden by derived classes. However, the method must call the on_connected() method after this. The sigConnected_ signal must also be invoked in the overriding method.

Parameters

[in] inName Name of the net to be Disconnected

Exceptions

Error Provided net was not found

Disconnect the named Net from this object.

Note: This metod can be overridden by derived classes. However, the method must call the on_connected() method after this. The sigConnected_ signal must also be invoked in the overriding method.

Parameters

[in] inNname Name of the net to be Disconnected

Exceptions

Error Provided net was not found

Definition at line 111 of file Connectable.cpp.

                                                                   {
     disconnect(std::find_if(mConnectedNets.begin(), mConnectedNets.end(),
         boost::bind<bool>(std::equal_to<std::string>(),
         boost::bind(boost::mem_fn(&Net::getName), _1), inName)));
 }

Here is the call graph for this function:

void torc::generic::Connectable::disconnect	(	const NetSharedPtr &	inNet	)
throw	(	Error
	)

inherited

Disconnect the given Net from this object.

Note: This metod can be overridden by derived classes. However, the method must call the on_disconnected() method after this. The sigDisconnected_ signal must also be invoked in the overriding method.

Parameters

[in] net Pointer to a net

Exceptions

Error Provided net was not found

Disconnect the given Net from this object.

Note: This metod can be overridden by derived classes. However, the method must call the on_disconnected() method after this. The sigDisconnected_ signal must also be invoked in the overriding method.

Parameters

[in] inNet Pointer to a net

Exceptions

Error Provided net was not found

Definition at line 128 of file Connectable.cpp.

                                                                     {
     disconnect(std::find(mConnectedNets.begin(), mConnectedNets.end(), inNet));
 }

void torc::generic::Net::disconnect	(		)
throw	(	Error
	)

virtual

Reimplemented from torc::generic::Connectable.

Reimplemented in torc::generic::VectorNet, and torc::generic::NetBundle.

Definition at line 311 of file generic/Net.cpp.

                                    {
     if(!getName().empty()) {
         log("Clearing net %s\n", getName().c_str());
     }
     mSubnets.clear();
     //Don't try to optimize the following by using applyOnAll
     // it causes memory corruption as the SymTab itself changes
     // during disconnection
     std::vector<PortSharedPtr> ports;
     getConnectedPorts(ports, true);
     void (Connectable::*fp)(const NetSharedPtr& net)
     = &Connectable::disconnect;
     std::for_each(ports.begin(), ports.end(), boost::bind(fp, _1, getSharedThis()));
     std::vector<PortReferenceSharedPtr> portRefs;
     getConnectedPortRefs(portRefs, true);
     std::for_each(portRefs.begin(), portRefs.end(), boost::bind(fp, _1, getSharedThis()));
     std::vector<PortListSharedPtr> portLists;
     getConnectedPortLists(portLists);
     std::for_each(portLists.begin(), portLists.end(), boost::bind(fp, _1, getSharedThis()));
     Connectable::disconnect();
 }

Here is the call graph for this function:

Here is the caller graph for this function:

PortSharedPtr torc::generic::Net::findConnectedPort	(	const std::string &	inName	)
throw	(	Error
	)

Find a port connected to this net.

Parameters

[in] inName Name of the port. If not found, empty pointer is returned

Definition at line 166 of file generic/Net.cpp.

                                                                           {
     PortSharedPtr port;
     std::list<PortSharedPtr>::iterator it = find_if(
         mConnectedPorts.begin(),
         mConnectedPorts.end(),
         boost::bind<bool>(std::equal_to<std::string>(),
             boost::bind(boost::mem_fn(&Port::getName), _1), inName));
     if(it != mConnectedPorts.end()) {
         port = *it;
     }
     return port;
 }

Here is the call graph for this function:

PortReferenceSharedPtr torc::generic::Net::findConnectedPortReference	(	const std::string &	inName	)
throw	(	Error
	)

Find a port reference connected to this net.

Parameters

[in] inName Name of the port reference. If not found, empty pointer is returned

Definition at line 266 of file generic/Net.cpp.

                                                                                             {
     PortReferenceSharedPtr portRef;
     std::list<PortReferenceSharedPtr>::iterator it = find_if(
         mConnectedPortRefs.begin(),
         mConnectedPortRefs.end(),
         boost::bind<bool>(std::equal_to<std::string>(),
             boost::bind(boost::mem_fn(&PortReference::getName), _1), inName));
     if(it != mConnectedPortRefs.end()) {
         portRef = *it;
     }
     return portRef;
 }

Here is the call graph for this function:

NetSharedPtr torc::generic::Net::findSubnet	(	const std::string &	inName	)
throw	(	Error
	)

Find a subnet from belonging to this net.

Parameters

[in] inName Name of the subnet. If not found, empty pointer is returned

Definition at line 85 of file generic/Net.cpp.

                                                                   {
     NetSharedPtr subnet;
     mSubnets.get(inName, subnet);
     return subnet;
 }

virtual const Pointer torc::generic::Composite< Net >::get	(	const std::vector< SizeType > &	inIndices	)	const
throw	(	Error
	)

pure virtualinherited

Get a specific member of this composition.

Note: This is relevant for Vector composition only. Other compositions return a NULL pointer

Parameters

[in] inIndices A list of indices to be accessed. The number of indices must be equal to the number of dimensions.

Returns: A pointer to the child situated at the specified indices. For non-relevant types a NULL pointer is returned

Exceptions

Error Index dimensions mismatch

Implemented in torc::generic::Vector< Net, VectorNetBit, VectorNetBit::Factory, true >, torc::generic::Bundle< Net >, torc::generic::VectorBit< Net >, and torc::generic::Scalar< Net >.

const NetAttributesSharedPtr torc::generic::Net::getAttributes ( ) const

inline

Get the attributes of the net. Attributes include criticality, netDelay etc.

Returns: Pointer to NetAttributes object.

Definition at line 303 of file generic/Net.hpp.

                                                              {
     return mAttributes;
 }

virtual void torc::generic::Composite< Net >::getChildren	(	List &	outChildren	)	const
throw	(	Error
	)

pure virtualinherited

Get children of this composition.

Note: This is relevant for Vector and Bundle compositions only. Other compositions return a NULL pointer

Parameters

[out] outChildren A list of all children for this composition

Implemented in torc::generic::Vector< Net, VectorNetBit, VectorNetBit::Factory, true >, torc::generic::Scalar< Net >, and torc::generic::VectorBit< Net >.

const std::vector< std::string > & torc::generic::Commentable::getComments ( ) const

inlineinherited

Get the list of all comments

Returns: A list of all comments on this object

Definition at line 85 of file Commentable.hpp.

                                                                   {
     return mComments;
 }

virtual CompositionType torc::generic::Composite< Net >::getCompositionType ( ) const

pure virtualinherited

Get the type of this composition.

Returns: Composition type for this object

Implemented in torc::generic::Vector< Net, VectorNetBit, VectorNetBit::Factory, true >, torc::generic::Bundle< Net >, torc::generic::VectorBit< Net >, and torc::generic::Scalar< Net >.

void torc::generic::Connectable::getConnectedNets	(	std::vector< NetSharedPtr > &	outNets,
		bool	inSkipChildConnections = `false`
	)		const
throw	(	Error
	)

virtualinherited

Get the vector of Nets that are Connected to the current object. The connected elements are appended to the given vector

Parameters

[out] outNets A vector of Connected nets

Get the vector of Nets that are Connected to the current object. The connected elements are appended to the given vector

Returns: A vector of Connected nets

Reimplemented in torc::generic::VectorPortReference, torc::generic::VectorNet, torc::generic::VectorPort, torc::generic::VectorNetBit, torc::generic::VectorPortBit, and torc::generic::VectorPortBitReference.

Definition at line 45 of file Connectable.cpp.

                         {
     outNets.insert(outNets.end(), mConnectedNets.begin(), mConnectedNets.end());
 }

Here is the caller graph for this function:

void torc::generic::Net::getConnectedPortLists ( std::vector< PortListSharedPtr > & outPortList ) const

virtual

Appends vector of connected port lists

Parameters

[in] outPortList vector of port lists to be appended to

Definition at line 213 of file generic/Net.cpp.

                                                                                {
     outPortList.insert(outPortList.end(), mConnectedPortLists.begin(), mConnectedPortLists.end());
     return;
 }

Here is the caller graph for this function:

void torc::generic::Net::getConnectedPortRefs	(	std::vector< PortReferenceSharedPtr > &	outPortRefs,
		bool	inSkipChildConnections = `false`
	)		const

virtual

Appends vector of connected port references

Parameters

[in] outPortRefs vector of port refs to be appended to

Reimplemented in torc::generic::VectorNet, and torc::generic::VectorNetBit.

Definition at line 279 of file generic/Net.cpp.

                                        {
     outPortRefs.insert(outPortRefs.end(), mConnectedPortRefs.begin(), mConnectedPortRefs.end());
     return;
 }

Here is the caller graph for this function:

void torc::generic::Net::getConnectedPorts	(	std::vector< PortSharedPtr > &	outPort,
		bool	inSkipChildConnections = `false`
	)		const

virtual

Appends vector of connected ports

Parameters

[in]	outPort	vector of port to be appended to
[in]	inSkipChildConnections	Return only ports connected to this port and skip returning elements that have been connected to the child

Reimplemented in torc::generic::VectorNet, and torc::generic::VectorNetBit.

Definition at line 179 of file generic/Net.cpp.

                                        {
     outPorts.insert(outPorts.end(), mConnectedPorts.begin(), mConnectedPorts.end());
     return;
 }

Here is the caller graph for this function:

const std::string torc::generic::Nameable::getName ( void ) const

inlinevirtualinherited

Get the object name

Returns: Name of the object

Definition at line 89 of file Nameable.hpp.

                                                {
     return mName;
 }

Here is the caller graph for this function:

Renamable::Name torc::generic::Renamable::getOriginalName ( ) const

inlinevirtualinherited

Get the new name provided for the object.

Returns: Name of the object

Definition at line 78 of file generic/Renamable.hpp.

                                                       {
     return mOriginalName;
 }

Here is the caller graph for this function:

const boost::shared_ptr<View > torc::generic::ParentedObject< View >::getParent ( ) const

inlineinherited

Get a pointer to the parent object

Returns: Pointer to parent

Here is the caller graph for this function:

virtual Pointer torc::generic::Composite< Net >::getParentCollection ( ) const

inlinevirtualinherited

Get a pointer to the parent collection

Returns: A pointer to the parent collection if present, empty pointer otherwise

Here is the caller graph for this function:

NetSharedPtr torc::generic::Net::getParentNet ( ) const

inline

Definition at line 294 of file generic/Net.hpp.

                                             {
     return mParentNet;
 }

void torc::generic::PropertyContainer::getProperties ( std::map< std::string, PropertySharedPtr > & outProperties ) const

inlineinherited

Get the map of all properties

Parameters

[out] outProperties The map of properties

Get the map of all properties

Returns: The map of properties

Definition at line 107 of file PropertyContainer.hpp.

                                                                {
     mProperties.getValueMap(outProperties);
     return;
 }

Here is the call graph for this function:

PropertySharedPtr torc::generic::PropertyContainer::getProperty ( const std::string & inName )

inherited

Get a property

Parameters

[in] inName Name of the property to be retreived

Returns: Pointer to the property object if present, empty pointer otherwise.

Get a property

Parameters

[in] name Name of the property to be retreived

Returns: Pointer to the property object if present, empty pointer otherwise.

Definition at line 37 of file PropertyContainer.cpp.

                                                                         {
     PropertySharedPtr property;
     if(!inName.empty()) {
         mProperties.get(inName, property);
     }
     return property;
 }

Here is the call graph for this function:

Here is the caller graph for this function:

Pointer torc::generic::SelfReferencing< Net >::getSharedThis ( ) const

inlineinherited

Get a shared pointer to this object. A valid pointer is returned if weakThis was set. Otherwise this returns a NULL pointer. For Vector types, the second scenario is an exception condition and should be treated as such.

Returns: A shared pointer to this object

Get a shared pointer to this object. A valid pointer is returned if weakThis was set. Otherwise this returns a NULL pointer. For Vector types, the second scenario is an exception condition and should be treated as such.

Parameters

[out] ptr Set to a shared pointer to this object

Here is the caller graph for this function:

virtual size_t torc::generic::Composite< Net >::getSize ( void ) const

pure virtualinherited

Get the total number of bits of the composition

Returns: Number of bits

Implemented in torc::generic::Vector< Net, VectorNetBit, VectorNetBit::Factory, true >, torc::generic::Bundle< Net >, torc::generic::VectorBit< Net >, and torc::generic::Scalar< Net >.

void torc::generic::Net::getSubnets ( std::vector< NetSharedPtr > & outSubnets ) const

inline

Definition at line 279 of file generic/Net.hpp.

                                                                      {
     mSubnets.getValues(outSubnets);
     return;
 }

Here is the call graph for this function:

void torc::generic::UserDataContainer::getUserData ( std::list< std::string > & outUserData ) const

inlineinherited

Get the list of all userData

Parameters

[out] outUserData The list of all userData

Definition at line 78 of file UserDataContainer.hpp.

                                                                                 {
     outUserData.insert(outUserData.end(), mUserData.begin(), mUserData.end());
     return;
 }

void torc::generic::Connectable::onConnect	(		)
throw	(	Error
	)

protectedvirtualinherited

A polymorphic function that is called after a net is Connected to this object

Definition at line 144 of file Connectable.cpp.

144 {}

void torc::generic::Connectable::onDisconnect	(		)
throw	(	Error
	)

protectedvirtualinherited

A polymorphic function that is called after a net is Disconnected from this object

Definition at line 149 of file Connectable.cpp.

149 {}

Net& torc::generic::Net::operator= ( const Net & source )

private

void torc::generic::Net::removeConnectedPort	(	const PortSharedPtr &	inPort	)
throw	(	Error
	)

protected

Definition at line 185 of file generic/Net.cpp.

                                                                        {
     std::list<PortSharedPtr>::iterator it = find(mConnectedPorts.begin(), mConnectedPorts.end(),
         inPort);
     if(it != mConnectedPorts.end()) {
         mConnectedPorts.erase(it);
     } else {
         Error e(eMessageIdErrorItemNotFound, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("Name", inPort->getName());
         throw e;
     }
     return;
 
 }

Here is the call graph for this function:

void torc::generic::Net::removeConnectedPortList	(	const PortListSharedPtr &	inList	)
throw	(	Error
	)

protected

Definition at line 226 of file generic/Net.cpp.

                                                                                    {
     std::list<PortListSharedPtr>::iterator it = find(mConnectedPortLists.begin(),
         mConnectedPortLists.end(), inPortList);
     if(it != mConnectedPortLists.end()) {
         mConnectedPortLists.erase(it);
     } else {
         Error e(eMessageIdErrorItemNotFound, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("Name", std::string("PortList"));
         throw e;
     }
     return;
 
 }

Here is the call graph for this function:

void torc::generic::Net::removeConnectedPortReference	(	const PortReferenceSharedPtr &	inPortRef	)
throw	(	Error
	)

protected

Definition at line 285 of file generic/Net.cpp.

                                                                                             {
     std::list<PortReferenceSharedPtr>::iterator it = find(mConnectedPortRefs.begin(),
         mConnectedPortRefs.end(), inPortRef);
     if(it != mConnectedPortRefs.end()) {
         mConnectedPortRefs.erase(it);
     } else {
         Error e(eMessageIdErrorItemNotFound, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("PortReference name", inPortRef->getName());
         throw e;
     }
     return;
 }

Here is the call graph for this function:

void torc::generic::Net::removeSubnet	(	const std::string &	inName	)
throw	(	Error
	)

Remove a subnet from this net.

Parameters

inName Name of the object to be delete

Exceptions

Error	Could not remove subnet, because subnet name is empty Id : eMessageIdErrorEmptyItemName Context Data Subnet name - String
Error	Could not remove subnet, because subnet not present. Id : eMessageIdErrorItemNotFound Context Data Subnet name - String

Remove a subnet from this net.

Parameters

inName Name of the object to be delete

Exceptions

Error	Could not remove subnet, because subnet name is empty
Error	Could not remove subnet, because subnet not present.

Definition at line 99 of file generic/Net.cpp.

                                                             {
     if(inName.empty()) {
         Error e(eMessageIdErrorEmptyItemName, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("Subnet name", inName);
         throw e;
     }
     if(false == mSubnets.remove(inName)) {
         Error e(eMessageIdErrorItemNotFound, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("Subnet name", inName);
         throw e;
     }
     return;
 }

Here is the call graph for this function:

void torc::generic::Net::setAttributes ( const NetAttributesSharedPtr & inSource )

Set the attributes of the net. Attributes include criticality, netDelay etc.

Parameters

[in] inSource Pointer to NetAttributes object.

Definition at line 122 of file generic/Net.cpp.

                                                               {
     mAttributes = inSource;
 }

void torc::generic::Commentable::setComments ( const std::vector< std::string > & inSource )

inherited

Get the list of all comments

Parameters

[in] inSource A list of all comments to be set on this object

Definition at line 45 of file Commentable.cpp.

                                                                   {
     mComments.insert(mComments.end(), inSource.begin(), inSource.end());
 }

void torc::generic::Net::setConnectedPortRefs	(	const std::vector< PortReferenceSharedPtr > &	inSource	)
throw	(	Error
	)

protected

Definition at line 298 of file generic/Net.cpp.

                                                                                               {
     std::vector<PortReferenceSharedPtr>::const_iterator portRef = inSource.begin();
     std::vector<PortReferenceSharedPtr>::const_iterator portRefEnd = inSource.end();
     for(; portRef != portRefEnd; ++portRef) {
         try {
             addConnectedPortReference(*portRef);
         } catch(Error& e) {
             e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
             throw;
         }
     }
 }

Here is the call graph for this function:

void torc::generic::Net::setConnectedPorts	(	const std::vector< PortSharedPtr > &	inSource	)
throw	(	Error
	)

protected

Definition at line 199 of file generic/Net.cpp.

                                                                                   {
     std::vector<PortSharedPtr>::const_iterator port = inSource.begin();
     std::vector<PortSharedPtr>::const_iterator portEnd = inSource.end();
     for(; port != portEnd; ++port) {
         try {
             addConnectedPort(*port);
         } catch(Error& e) {
             e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
             throw;
         }
     }
 
 }

Here is the call graph for this function:

void torc::generic::Nameable::setName	(	const std::string &	inSource	)
throw	(	Error
	)

inherited

Set a name for this object

Parameters

[in] inSource Name of the object

Exceptions

Error

Could not set name, because name is empty (Will be used by array members)

Id : eMessageIdErrorEmptyItemName
Context Data
- Nameable - String

Set a name for this object

Parameters

[in] inSource Name of the object

Exceptions

Error Could not set name, because name is empty (Will be used by array members)

Definition at line 41 of file Nameable.cpp.

                                                               {
     if(inSource.empty()) {
         Error e(eMessageIdErrorEmptyItemName, __FUNCTION__, __FILE__, __LINE__);
         e.saveContextData("Nameable", inSource);
         throw e;
     }
     mName = inSource;
 }

Here is the call graph for this function:

void torc::generic::Renamable::setOriginalName ( const Name & inSource )

virtualinherited

Set the new name provided for the object.

Parameters

[in] inSource Name of the object

Definition at line 35 of file generic/Renamable.cpp.

                                                              {
     mOriginalName = inSource;
 }

virtual void torc::generic::ParentedObject< View >::setParent ( const boost::shared_ptr< View > & inSource )

virtualinherited

Set a pointer to the parent

Parameters

[in] inSource Set a pointer to the parent

Here is the caller graph for this function:

virtual void torc::generic::Composite< Net >::setParentCollection ( const Pointer & inParentCollection )

inlinevirtualinherited

Set a pointer to a parnt composition.

Parameters

[in] inParentCollection pointer to the parent collection (Vector/Bundle)

Set a pointer to a parnt composition.

Parameters

[in] parentCollection pointer to the parent collection (Vector/Bundle)

void torc::generic::Net::setParentNet ( const NetSharedPtr & inParent )

Definition at line 113 of file generic/Net.cpp.

                                                    {
     mParentNet = inParent;
 }

void torc::generic::PropertyContainer::setProperties ( const std::map< std::string, PropertySharedPtr > & inSource )

inherited

Set the map of properties

Parameters

[in] inSource The map of properties

Definition at line 66 of file PropertyContainer.cpp.

                                                                                           {
     std::map<std::string, PropertySharedPtr>::const_iterator it = inSource.begin();
     for(; it != inSource.end(); it++) {
         setProperty((*it).first, (*it).second);
     }
 }

Here is the call graph for this function:

bool torc::generic::PropertyContainer::setProperty	(	const std::string &	inName,
		const PropertySharedPtr &	inProperty
	)

inherited

Save the inSource of a property

Parameters

[in]	inName	Name of the property to be saved
[in]	inProperty	Pointer to the property object if present, empty pointer otherwise.

Returns: bool True if saved, false otherwise.

Save the inSource of a property

Parameters

[in]	inName	Name of the property to be saved
[in]	inPoperty	Pointer to the property object if present, empty pointer otherwise.

Returns: bool True if saved, false otherwise.

Definition at line 53 of file PropertyContainer.cpp.

                                          {
     if(!inName.empty()) {
         return mProperties.set(inName, inProperty);
     }
     return false;
 }

Here is the call graph for this function:

Here is the caller graph for this function:

void torc::generic::Net::setSubnets	(	const std::vector< NetSharedPtr > &	inSource	)
throw	(	Error
	)

Definition at line 126 of file generic/Net.cpp.

                                                                           {
     std::vector<NetSharedPtr>::const_iterator subnet = inSource.begin();
     std::vector<NetSharedPtr>::const_iterator subEnd = inSource.end();
     for(; subnet != subEnd; ++subnet) {
         try {
             addSubnet(*subnet);
         } catch(Error& e) {
             e.setCurrentLocation(__FUNCTION__, __FILE__, __LINE__);
             throw;
         }
     }
 }

Here is the call graph for this function:

void torc::generic::UserDataContainer::setUserData ( const std::list< std::string > & inSource )

inherited

Set the list of userData

Parameters

[in] inSource The list of UserData

Definition at line 26 of file UserDataContainer.cpp.

                                                                       {
     mUserData.insert(mUserData.end(), inSource.begin(), inSource.end());
 }

void torc::generic::SelfReferencing< Net >::setWeakThis ( const WeakPointer & inWeakThis )

inlineinherited

Set a weak pointer to this object. This will be used later to get a shared pointer to this object from within other member methods if required. This should be called by the Factory creating the object.

Parameters

[in] weakThis A weak pointer to this object

Connectable::Connected & torc::generic::Connectable::signalNetConnected ( )

inlineinherited

A signal to indicate that a new connection has been made

Definition at line 167 of file Connectable.hpp.

                                                              {
     return mSigNetConnected;
 }

Connectable::Disconnected & torc::generic::Connectable::signalNetDisconnected ( )

inlineinherited

A signal to indicate that a new connection has been made

Definition at line 174 of file Connectable.hpp.

                                                                    {
     return mSigNetDisconnected;
 }

Friends And Related Function Documentation

friend class ConnectionHandler

friend

Definition at line 64 of file generic/Net.hpp.

Field Documentation

NetAttributesSharedPtr torc::generic::Net::mAttributes

private

Definition at line 276 of file generic/Net.hpp.

std::list<PortListSharedPtr> torc::generic::Net::mConnectedPortLists

private

Definition at line 273 of file generic/Net.hpp.

std::list<PortReferenceSharedPtr> torc::generic::Net::mConnectedPortRefs

private

Definition at line 274 of file generic/Net.hpp.

std::list<PortSharedPtr> torc::generic::Net::mConnectedPorts

private

Definition at line 272 of file generic/Net.hpp.

NetSharedPtr torc::generic::Net::mParentNet

private

Definition at line 275 of file generic/Net.hpp.

SymTab<std::string, NetSharedPtr, true> torc::generic::Net::mSubnets

private

Definition at line 271 of file generic/Net.hpp.

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Field Documentation