single_link_registry Class
The single_link_registry
object is a network_link_registry
that manages only a single source or target block.
Syntax
template<class _Block>
class single_link_registry : public network_link_registry<_Block>;
Parameters
_Block
The block data type being stored in the single_link_registry
object.
Members
Public Constructors
Name | Description |
---|---|
single_link_registry | Constructs a single_link_registry object. |
~single_link_registry Destructor | Destroys the single_link_registry object. |
Public Methods
Name | Description |
---|---|
add | Adds a link to the single_link_registry object. (Overrides network_link_registry::add.) |
begin | Returns an iterator to the first element in the single_link_registry object. (Overrides network_link_registry::begin.) |
contains | Searches the single_link_registry object for a specified block. (Overrides network_link_registry::contains.) |
count | Counts the number of items in the single_link_registry object. (Overrides network_link_registry::count.) |
remove | Removes a link from the single_link_registry object. (Overrides network_link_registry::remove.) |
Inheritance Hierarchy
single_link_registry
Requirements
Header: agents.h
Namespace: concurrency
add
Adds a link to the single_link_registry
object.
virtual void add(_EType _Link);
Parameters
_Link
A pointer to a block to be added.
Remarks
The method throws an invalid_link_target exception if there is already a link in this registry.
begin
Returns an iterator to the first element in the single_link_registry
object.
virtual iterator begin();
Return Value
An iterator addressing the first element in the single_link_registry
object.
Remarks
The end state is indicated by a NULL
link.
contains
Searches the single_link_registry
object for a specified block.
virtual bool contains(_EType _Link);
Parameters
_Link
A pointer to a block that is to be searched for in the single_link_registry
object.
Return Value
true
if the link was found, false
otherwise.
count
Counts the number of items in the single_link_registry
object.
virtual size_t count();
Return Value
The number of items in the single_link_registry
object.
remove
Removes a link from the single_link_registry
object.
virtual bool remove(_EType _Link);
Parameters
_Link
A pointer to a block to be removed, if found.
Return Value
true
if the link was found and removed, false
otherwise.
single_link_registry
Constructs a single_link_registry
object.
single_link_registry();
~single_link_registry
Destroys the single_link_registry
object.
virtual ~single_link_registry();
Remarks
The method throws an invalid_operation exception if it is called before the link is removed.