Chemical Data Processing Library C++ API - Version 1.1.1
Classes | Public Types | Public Member Functions | List of all members
CDPL::Chem::ConnectedSubstructureSet Class Reference

ConnectedSubstructureSet. More...

#include <ConnectedSubstructureSet.hpp>

+ Inheritance diagram for CDPL::Chem::ConnectedSubstructureSet:

Public Types

typedef std::shared_ptr< ConnectedSubstructureSetSharedPointer
 A reference-counted smart pointer [SHPTR] for dynamically allocated ConnectedSubstructureSet instances. More...
 
- Public Types inherited from CDPL::Chem::FragmentList
typedef std::shared_ptr< FragmentListSharedPointer
 
- Public Types inherited from CDPL::Util::IndirectArray< Fragment >
typedef Array< typename ValueType::SharedPointer > BaseType
 The type of the public Array<PointerType> base class storing the pointer elements. More...
 
typedef Fragment ElementType
 The type of the object that is obtained after dereferenciation of a stored pointer element. More...
 
typedef std::shared_ptr< IndirectArraySharedPointer
 A reference-counted smart pointer [SHPTR] for dynamically allocated IndirectArray instances. More...
 
typedef boost::transform_iterator< DerefFunc, typename BaseType::ConstElementIterator, const Fragment & > ConstElementIterator
 A constant random access iterator used to iterate over the pointed-to objects. More...
 
typedef boost::transform_iterator< DerefFunc, typename BaseType::ConstReverseElementIterator, const Fragment & > ConstReverseElementIterator
 A constant random access iterator used to iterate over the pointed-to objects in reverse order. More...
 
typedef boost::transform_iterator< DerefFunc, typename BaseType::ElementIterator, Fragment & > ElementIterator
 A mutable random access iterator used to iterate over the pointed-to objects. More...
 
typedef boost::transform_iterator< DerefFunc, typename BaseType::ReverseElementIterator, Fragment & > ReverseElementIterator
 A mutable random access iterator used to iterate over the pointed-to objects in reverse order. More...
 
- Public Types inherited from CDPL::Util::Array< typename ValueType::SharedPointer >
typedef std::vector< typename ValueType::SharedPointer > StorageType
 
typedef std::shared_ptr< ArraySharedPointer
 A reference-counted smart pointer [SHPTR] for dynamically allocated Array instances. More...
 
typedef typename ValueType::SharedPointer ElementType
 The type of objects stored by the array. More...
 
typedef std::size_t SizeType
 The type of objects stored by the array. More...
 
typedef Array BaseType
 Specifies for derived classes the type of the Array base class. More...
 
typedef StorageType::const_iterator ConstElementIterator
 A constant random access iterator used to iterate over the elements of the array. More...
 
typedef StorageType::const_reverse_iterator ConstReverseElementIterator
 A constant random access iterator used to iterate over the elements of the array in reverse order. More...
 
typedef StorageType::iterator ElementIterator
 A mutable random access iterator used to iterate over the elements of the array. More...
 
typedef StorageType::reverse_iterator ReverseElementIterator
 A mutable random access iterator used to iterate over the elements of the array in reverse order. More...
 

Public Member Functions

 ConnectedSubstructureSet ()
 Constructs an empty ConnectedSubstructureSet instance. More...
 
 ConnectedSubstructureSet (const MolecularGraph &molgraph)
 Constructs and initialzes a ConnectedSubstructureSet instance for the molecular graph molgraph. More...
 
void reset (const MolecularGraph &molgraph)
 Specifies the molecular graph that is searched for connected substructures. More...
 
void findSubstructures (std::size_t size)
 Searches the specified molecular graph for connected substructures of the given size. More...
 
std::size_t getSubstructureSize () const
 Returns the current substructure size in terms of number of bonds. More...
 
- Public Member Functions inherited from CDPL::Util::IndirectArray< Fragment >
 IndirectArray ()
 Creates an empty array. More...
 
 IndirectArray (std::size_t num_elem, const typename ValueType::SharedPointer &ptr=typename ValueType::SharedPointer())
 Creates and initializes the array with num_elem copies of ptr. More...
 
 IndirectArray (const InputIter &first, const InputIter &last)
 Creates and initializes the array with copies of the pointers in the range [first, last). More...
 
virtual ~IndirectArray ()
 Virtual destructor. More...
 
ElementIterator insertElement (const ElementIterator &it, const typename ValueType::SharedPointer &ptr)
 Inserts a new element before the location specified by the iterator it. More...
 
void insertElement (std::size_t idx, const Fragment &value=Fragment())
 Inserts a new element before the location specified by the index idx. More...
 
ElementIterator insertElement (const ElementIterator &it, const Fragment &value=Fragment())
 Inserts a new element before the location specified by the iterator it. More...
 
void insertElements (const ElementIterator &it, std::size_t num_elem, const typename ValueType::SharedPointer &ptr)
 Inserts num_elem copies of ptr before the location specified by the iterator it. More...
 
void insertElements (const ElementIterator &it, const InputIter &first, const InputIter &last)
 Inserts the range of pointers [first, last) before the location specified by the iterator it. More...
 
void insertElements (std::size_t idx, std::size_t num_elem, const Fragment &value=Fragment())
 Inserts num_elem copies of value before the location specified by the index idx. More...
 
void insertElements (const ElementIterator &it, std::size_t num_elem, const Fragment &value=Fragment())
 Inserts num_elem copies of value before the location specified by the iterator it. More...
 
void insertElements (std::size_t idx, const InputIter &first, const InputIter &last)
 Inserts the range of elements [first, last) before the location specified by the index idx. More...
 
void insertElements (const ElementIterator &it, const InputIter &first, const InputIter &last)
 Inserts the range of elements [first, last) before the location specified by the iterator it. More...
 
ElementIterator removeElement (const ElementIterator &it)
 Removes the element at the position specified by the iterator it. More...
 
void removeElement (std::size_t idx)
 Removes the element at the position specified by the index idx. More...
 
ElementIterator removeElement (const ElementIterator &it)
 Removes the element at the position specified by the iterator it. More...
 
ElementIterator removeElements (const ElementIterator &first, const ElementIterator &last)
 Removes the elements pointed to by the iterators in the range [first, last). More...
 
ElementIterator removeElements (const ElementIterator &first, const ElementIterator &last)
 Removes the elements pointed to by the iterators in the range [first, last). More...
 
const Fragment & getFirstElement () const
 Returns a const reference to the object pointed to by the first element of the array. More...
 
Fragment & getFirstElement ()
 Returns a non-const reference to the object pointed to by the first element of the array. More...
 
const Fragment & getLastElement () const
 Returns a const reference to the object pointed to by the last element of the array. More...
 
Fragment & getLastElement ()
 Returns a non-const reference to the object pointed to by the last element of the array. More...
 
ConstElementIterator getElementsBegin () const
 Returns a constant iterator over the pointed-to objects that points to the beginning of the array. More...
 
ElementIterator getElementsBegin ()
 Returns a mutable iterator over the pointed-to objects that points to the beginning of the array. More...
 
ConstElementIterator getElementsEnd () const
 Returns a constant iterator over the pointed-to objects that points to the end of the array. More...
 
ElementIterator getElementsEnd ()
 Returns a mutable iterator over the pointed-to objects that points to the end of the array. More...
 
ConstElementIterator begin () const
 Returns a constant iterator over the pointed-to objects that points to the beginning of the array. More...
 
ElementIterator begin ()
 Returns a mutable iterator over the pointed-to objects that points to the beginning of the array. More...
 
ConstElementIterator end () const
 Returns a constant iterator over the pointed-to objects that points to the end of the array. More...
 
ElementIterator end ()
 Returns a mutable iterator over the pointed-to objects that points to the end of the array. More...
 
ConstReverseElementIterator getElementsReverseBegin () const
 Returns a constant iterator over the pointed-to objects that points to the beginning of the reversed array. More...
 
ReverseElementIterator getElementsReverseBegin ()
 Returns a mutable iterator over the pointed-to objects that points to the beginning of the reversed array. More...
 
ConstReverseElementIterator getElementsReverseEnd () const
 Returns a constant iterator over the pointed-to objects that points to the end of the reversed array. More...
 
ReverseElementIterator getElementsReverseEnd ()
 Returns a mutable iterator over the pointed-to objects that points to the end of the reversed array. More...
 
const Fragment & getElement (std::size_t idx) const
 Returns a const reference to the object pointed-to by the pointer element at index idx. More...
 
Fragment & getElement (std::size_t idx)
 Returns a non-const reference to the object pointed-to by the pointer element at index idx. More...
 
const Fragment & operator[] (std::size_t idx) const
 Returns a const reference to the object pointed-to by the pointer element at index idx. More...
 
Fragment & operator[] (std::size_t idx)
 Returns a non-const reference to the object pointed-to by the pointer element at index idx. More...
 
- Public Member Functions inherited from CDPL::Util::Array< typename ValueType::SharedPointer >
 Array ()
 Creates an empty array. More...
 
 Array (std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
 Creates and initializes the array with num_elem copies of value. More...
 
 Array (const InputIter &first, const InputIter &last)
 Creates and initializes the array with copies of the elements in the range [first, last). More...
 
virtual ~Array ()
 Virtual destructor. More...
 
StorageTypegetData ()
 
const StorageTypegetData () const
 
BaseTypegetBase ()
 Returns a non-const reference to itself. More...
 
const BaseTypegetBase () const
 Returns a const reference to itself. More...
 
std::size_t getSize () const
 Returns the number of elements stored in the array. More...
 
std::size_t size () const
 Returns the number of elements stored in the array. More...
 
bool isEmpty () const
 Tells whether the array is empty (getSize() == 0). More...
 
void resize (std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
 Inserts or erases elements at the end so that the size becomes num_elem. More...
 
void reserve (std::size_t num_elem)
 Preallocates memory for (at least) num_elem elements. More...
 
std::size_t getCapacity () const
 Returns the number of elements for which memory has been allocated. More...
 
void clear ()
 Erases all elements. More...
 
void swap (Array &array)
 Swaps the contents with array. More...
 
void assign (std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
 This function fills the array with num_elem copies of the given value. More...
 
void assign (const InputIter &first, const InputIter &last)
 This function fills a vector with copies of the elements in the range [first, last). More...
 
void addElement (const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
 Inserts a new element at the end of the array. More...
 
void insertElement (std::size_t idx, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
 Inserts a new element before the location specified by the index idx. More...
 
ElementIterator insertElement (const ElementIterator &it, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
 Inserts a new element before the location specified by the iterator it. More...
 
void insertElements (std::size_t idx, std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
 Inserts num_elem copies of value before the location specified by the index idx. More...
 
void insertElements (const ElementIterator &it, std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
 Inserts num_elem copies of value before the location specified by the iterator it. More...
 
void insertElements (std::size_t idx, const InputIter &first, const InputIter &last)
 Inserts the range of elements [first, last) before the location specified by the index idx. More...
 
void insertElements (const ElementIterator &it, const InputIter &first, const InputIter &last)
 Inserts the range of elements [first, last) before the location specified by the iterator it. More...
 
void popLastElement ()
 Removes the last element of the array. More...
 
void removeElement (std::size_t idx)
 Removes the element at the position specified by the index idx. More...
 
ElementIterator removeElement (const ElementIterator &it)
 Removes the element at the position specified by the iterator it. More...
 
ElementIterator removeElements (const ElementIterator &first, const ElementIterator &last)
 Removes the elements pointed to by the iterators in the range [first, last). More...
 
const typename ValueType::SharedPointer & getFirstElement () const
 Returns a const reference to the first element of the array. More...
 
typename ValueType::SharedPointer & getFirstElement ()
 Returns a non-const reference to the first element of the array. More...
 
const typename ValueType::SharedPointer & getLastElement () const
 Returns a const reference to the last element of the array. More...
 
typename ValueType::SharedPointer & getLastElement ()
 Returns a non-const reference to the last element of the array. More...
 
ConstElementIterator getElementsBegin () const
 Returns a constant iterator pointing to the beginning of the array. More...
 
ElementIterator getElementsBegin ()
 Returns a mutable iterator pointing to the beginning of the array. More...
 
ConstElementIterator getElementsEnd () const
 Returns a constant iterator pointing to the end of the array. More...
 
ElementIterator getElementsEnd ()
 Returns a mutable iterator pointing to the end of the array. More...
 
ConstElementIterator begin () const
 Returns a constant iterator pointing to the beginning of the array. More...
 
ElementIterator begin ()
 Returns a mutable iterator pointing to the beginning of the array. More...
 
ConstElementIterator end () const
 Returns a constant iterator pointing to the end of the array. More...
 
ElementIterator end ()
 Returns a mutable iterator pointing to the end of the array. More...
 
ConstReverseElementIterator getElementsReverseBegin () const
 Returns a constant iterator pointing to the beginning of the reversed array. More...
 
ReverseElementIterator getElementsReverseBegin ()
 Returns a mutable iterator pointing to the beginning of the reversed array. More...
 
ConstReverseElementIterator getElementsReverseEnd () const
 Returns a constant iterator pointing to the end of the reversed array. More...
 
ReverseElementIterator getElementsReverseEnd ()
 Returns a mutable iterator pointing to the end of the reversed array. More...
 
const typename ValueType::SharedPointer & getElement (std::size_t idx) const
 Returns a const reference to the element at index idx. More...
 
typename ValueType::SharedPointer & getElement (std::size_t idx)
 Returns a non-const reference to the element at index idx. More...
 
void setElement (std::size_t idx, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
 Assigns a new value to the element specified by the index idx. More...
 
const typename ValueType::SharedPointer & operator[] (std::size_t idx) const
 Returns a const reference to the element at index idx. More...
 
typename ValueType::SharedPointer & operator[] (std::size_t idx)
 Returns a non-const reference to the element at index idx. More...
 

Additional Inherited Members

- Protected Member Functions inherited from CDPL::Util::Array< typename ValueType::SharedPointer >
void checkIfNonEmpty () const
 
void checkIndex (std::size_t idx, bool allow_end) const
 
void checkIterator (const ElementIterator &it, bool allow_end)
 
void checkIterator (const ConstElementIterator &it, bool allow_end) const
 

Detailed Description

ConnectedSubstructureSet.

Member Typedef Documentation

◆ SharedPointer

A reference-counted smart pointer [SHPTR] for dynamically allocated ConnectedSubstructureSet instances.

Constructor & Destructor Documentation

◆ ConnectedSubstructureSet() [1/2]

CDPL::Chem::ConnectedSubstructureSet::ConnectedSubstructureSet ( )

Constructs an empty ConnectedSubstructureSet instance.

◆ ConnectedSubstructureSet() [2/2]

CDPL::Chem::ConnectedSubstructureSet::ConnectedSubstructureSet ( const MolecularGraph molgraph)

Constructs and initialzes a ConnectedSubstructureSet instance for the molecular graph molgraph.

Parameters
molgraphThe molecular graph to search for connected substructures.

Member Function Documentation

◆ reset()

void CDPL::Chem::ConnectedSubstructureSet::reset ( const MolecularGraph molgraph)

Specifies the molecular graph that is searched for connected substructures.

The current substructure size is reset to zero.

Parameters
molgraphThe molecular graph to search for connected substructures.

◆ findSubstructures()

void CDPL::Chem::ConnectedSubstructureSet::findSubstructures ( std::size_t  size)

Searches the specified molecular graph for connected substructures of the given size.

If a molecular graph has not yet been specified (in the constructor or by a prior call to reset(const Chem::MolecularGraph&)), the method has no effect. Otherwise, all connected substructures of the specified size are added as Chem::Fragment objects to the list of previously found (if any) substructures. If the specified size is zero, substructures of size 1 (i.e. the bonds of the molecular graph) will be extracted.

Parameters
sizeThe substructure size in terms of number of bonds.

◆ getSubstructureSize()

std::size_t CDPL::Chem::ConnectedSubstructureSet::getSubstructureSize ( ) const

Returns the current substructure size in terms of number of bonds.

The current substructure size corresponds to the size that was specified in the the last call to findSubstructures(). If findSubstructures() has not yet been called, the current substructure size is zero.

Returns
The current substructure size.

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