Chemical Data Processing Library Python API - Version 1.1.1
Public Member Functions | Properties | List of all members
CDPL.Chem.MolecularGraphMatchExpressionList Class Reference
+ Inheritance diagram for CDPL.Chem.MolecularGraphMatchExpressionList:

Public Member Functions

None __init__ ()
 Creates an empty list.
 
None __init__ (MolecularGraphMatchExpressionList expr)
 Initializes a copy of the MolecularGraphMatchExpressionList instance expr. More...
 
int getObjectID ()
 Returns the numeric identifier (ID) of the wrapped C++ class instance. More...
 
int getSize ()
 Returns the number of elements stored in the list. More...
 
bool isEmpty ()
 Tells whether the list is empty (getSize() == 0). More...
 
None resize (int num_elem, MolecularGraphMatchExpression value)
 Inserts or erases elements at the end so that the size becomes num_elem. More...
 
None reserve (int num_elem)
 Preallocates memory for (at least) num_elem elements. More...
 
int getCapacity ()
 Returns the number of elements for which memory has been allocated. More...
 
None clear ()
 Erases all elements.
 
MolecularGraphMatchExpressionList assign (MolecularGraphMatchExpressionList array)
 Replaces the current state of self with a copy of the state of the MolecularGraphMatchExpressionList instance array. More...
 
None assign (int num_elem, MolecularGraphMatchExpression value)
 This function fills the list with num_elem copies of the given value. More...
 
None addElement (MolecularGraphMatchExpression value)
 Inserts a new element at the end of the list. More...
 
None addElements (MolecularGraphMatchExpressionList values)
 
None insertElement (int idx, MolecularGraphMatchExpression value)
 Inserts a new element before the location specified by the index idx. More...
 
None insertElements (int idx, int num_elem, MolecularGraphMatchExpression value)
 Inserts num_elem copies of value before the location specified by the index idx. More...
 
None insertElements (int index, MolecularGraphMatchExpressionList values)
 
None popLastElement ()
 Removes the last element of the list. More...
 
None removeElement (int idx)
 Removes the element at the position specified by the index idx. More...
 
None removeElements (int begin_idx, int end_idx)
 
MolecularGraphMatchExpression getFirstElement ()
 Returns a reference to the first element of the list. More...
 
MolecularGraphMatchExpression getLastElement ()
 Returns a reference to the last element of the list. More...
 
MolecularGraphMatchExpression getElement (int idx)
 Returns a reference to the element at index idx. More...
 
None setElement (int idx, MolecularGraphMatchExpression value)
 Assigns a new value to the element specified by the index idx. More...
 
None __delitem__ (int idx)
 
MolecularGraphMatchExpression __getitem__ (int idx)
 
int __len__ ()
 
None __setitem__ (int index, MolecularGraphMatchExpression value)
 
bool __eq__ (object expr)
 Returns the result of the comparison operation self == expr. More...
 
bool __ne__ (object expr)
 Returns the result of the comparison operation self != expr. More...
 
- Public Member Functions inherited from CDPL.Chem.MolecularGraphMatchExpression
bool requiresAtomBondMapping ()
 Tells whether the expression must be reevaluated after a query to target atom/bond mapping candidate has been found. More...
 
bool __call__ (MolecularGraph query_molgraph, MolecularGraph target_molgraph, Base.Any aux_data)
 Performs an evaluation of the expression for the given query and target molecular graphs. More...
 
bool __call__ (MolecularGraph query_molgraph, MolecularGraph target_molgraph, AtomBondMapping mapping, Base.Any aux_data)
 Performs an evaluation of the expression for the given query and target molecular graphs under consideration of the provided candidate atom/bond mapping. More...
 

Properties

 objectID = property(getObjectID)
 
 size = property(getSize)
 
- Properties inherited from CDPL.Chem.MolecularGraphMatchExpression
 objectID = property(getObjectID)
 

Constructor & Destructor Documentation

◆ __init__()

None CDPL.Chem.MolecularGraphMatchExpressionList.__init__ ( MolecularGraphMatchExpressionList  expr)

Initializes a copy of the MolecularGraphMatchExpressionList instance expr.

Parameters
exprThe MolecularGraphMatchExpressionList instance to copy.

Member Function Documentation

◆ getObjectID()

int CDPL.Chem.MolecularGraphMatchExpressionList.getObjectID ( )

Returns the numeric identifier (ID) of the wrapped C++ class instance.

Different Python MolecularGraphMatchExpressionList instances may reference the same underlying C++ class instance. The commonly used Python expression a is not b thus cannot tell reliably whether the two MolecularGraphMatchExpressionList instances a and b reference different C++ objects. The numeric identifier returned by this method allows to correctly implement such an identity test via the simple expression a.getObjectID() != b.getObjectID().

Returns
The numeric ID of the internally referenced C++ class instance.

Reimplemented from CDPL.Chem.MolecularGraphMatchExpression.

◆ getSize()

int CDPL.Chem.MolecularGraphMatchExpressionList.getSize ( )

Returns the number of elements stored in the list.

Returns
The size of the list.

◆ isEmpty()

bool CDPL.Chem.MolecularGraphMatchExpressionList.isEmpty ( )

Tells whether the list is empty (getSize() == 0).

Returns
True if the list is empty, False otherwise.

◆ resize()

None CDPL.Chem.MolecularGraphMatchExpressionList.resize ( int  num_elem,
MolecularGraphMatchExpression  value 
)

Inserts or erases elements at the end so that the size becomes num_elem.

Parameters
num_elemThe new size.
valueThe value for newly inserted elements.

◆ reserve()

None CDPL.Chem.MolecularGraphMatchExpressionList.reserve ( int  num_elem)

Preallocates memory for (at least) num_elem elements.

If num_elem is less than or equal to the current capacity, this call has no effect. Otherwise, it is a request for allocation of additional memory. If the request is successful, then the capacity is greater than or equal to num_elem. Otherwise, the capacity is unchanged. In either case, the number of elements will not change.

Parameters
num_elemThe number of elements to reserve memory for.
See also
getCapacity()

◆ getCapacity()

int CDPL.Chem.MolecularGraphMatchExpressionList.getCapacity ( )

Returns the number of elements for which memory has been allocated.

The capacity is always greater than or equal to the number of currently stored elements.

Returns
The current capacity.

◆ assign() [1/2]

MolecularGraphMatchExpressionList CDPL.Chem.MolecularGraphMatchExpressionList.assign ( MolecularGraphMatchExpressionList  array)

Replaces the current state of self with a copy of the state of the MolecularGraphMatchExpressionList instance array.

Parameters
arrayThe MolecularGraphMatchExpressionList instance to copy.
Returns
self

◆ assign() [2/2]

None CDPL.Chem.MolecularGraphMatchExpressionList.assign ( int  num_elem,
MolecularGraphMatchExpression  value 
)

This function fills the list with num_elem copies of the given value.

Note that the assignment completely changes the list and the new size is the same as the number of elements assigned. Old data will be lost.

Parameters
num_elemThe number of elements to be assigned.
valueThe value to be assigned.

◆ addElement()

None CDPL.Chem.MolecularGraphMatchExpressionList.addElement ( MolecularGraphMatchExpression  value)

Inserts a new element at the end of the list.

Parameters
valueThe value of the new element.

◆ addElements()

None CDPL.Chem.MolecularGraphMatchExpressionList.addElements ( MolecularGraphMatchExpressionList  values)
Parameters
values

◆ insertElement()

None CDPL.Chem.MolecularGraphMatchExpressionList.insertElement ( int  idx,
MolecularGraphMatchExpression  value 
)

Inserts a new element before the location specified by the index idx.

Parameters
idxThe location where to insert the new element.
valueThe value of the element to insert.
Exceptions
Base.IndexErrorif the list is empty or idx is not in the range [0, getSize()].

◆ insertElements() [1/2]

None CDPL.Chem.MolecularGraphMatchExpressionList.insertElements ( int  idx,
int  num_elem,
MolecularGraphMatchExpression  value 
)

Inserts num_elem copies of value before the location specified by the index idx.

Parameters
idxThe location where to insert the new elements.
num_elemThe number of elements to insert.
valueThe value of the elements to insert.
Exceptions
Base.IndexErrorif idx is not in the range [0, getSize()].

◆ insertElements() [2/2]

None CDPL.Chem.MolecularGraphMatchExpressionList.insertElements ( int  index,
MolecularGraphMatchExpressionList  values 
)
Parameters
index
values

◆ popLastElement()

None CDPL.Chem.MolecularGraphMatchExpressionList.popLastElement ( )

Removes the last element of the list.

Exceptions
Base.OperationFailedif the list is empty.

◆ removeElement()

None CDPL.Chem.MolecularGraphMatchExpressionList.removeElement ( int  idx)

Removes the element at the position specified by the index idx.

Parameters
idxThe zero-based index of the element to remove.
Exceptions
Base.IndexErrorif the list is empty or idx is not in the range [0, getSize() - 1].

◆ removeElements()

None CDPL.Chem.MolecularGraphMatchExpressionList.removeElements ( int  begin_idx,
int  end_idx 
)
Parameters
begin_idx
end_idx

◆ getFirstElement()

MolecularGraphMatchExpression CDPL.Chem.MolecularGraphMatchExpressionList.getFirstElement ( )

Returns a reference to the first element of the list.

Returns
A reference to the first element.
Exceptions
Base.OperationFailedif the list is empty.

◆ getLastElement()

MolecularGraphMatchExpression CDPL.Chem.MolecularGraphMatchExpressionList.getLastElement ( )

Returns a reference to the last element of the list.

Returns
A reference to the last element.
Exceptions
Base.OperationFailedif the list is empty.

◆ getElement()

MolecularGraphMatchExpression CDPL.Chem.MolecularGraphMatchExpressionList.getElement ( int  idx)

Returns a reference to the element at index idx.

The method is equivalent to operator[](std::size_t).

Parameters
idxThe zero-based index of the element.
Returns
A reference to the element.
Exceptions
Base.IndexErrorif the list is empty or idx is not in the range [0, getSize() - 1].

◆ setElement()

None CDPL.Chem.MolecularGraphMatchExpressionList.setElement ( int  idx,
MolecularGraphMatchExpression  value 
)

Assigns a new value to the element specified by the index idx.

Parameters
idxThe zero-based index of the element for which to assign a new value.
valueThe new value of the element after assignment.
Exceptions
Base.IndexErrorif the list is empty or idx is not in the range [0, getSize() - 1].

◆ __delitem__()

None CDPL.Chem.MolecularGraphMatchExpressionList.__delitem__ ( int  idx)
Parameters
idx

◆ __getitem__()

MolecularGraphMatchExpression CDPL.Chem.MolecularGraphMatchExpressionList.__getitem__ ( int  idx)
Parameters
idx
Returns

◆ __len__()

int CDPL.Chem.MolecularGraphMatchExpressionList.__len__ ( )
Returns

◆ __setitem__()

None CDPL.Chem.MolecularGraphMatchExpressionList.__setitem__ ( int  index,
MolecularGraphMatchExpression  value 
)
Parameters
index
value

◆ __eq__()

bool CDPL.Chem.MolecularGraphMatchExpressionList.__eq__ ( object  expr)

Returns the result of the comparison operation self == expr.

Parameters
exprThe object instance to be compared with.
Returns
The result of the comparison operation.

◆ __ne__()

bool CDPL.Chem.MolecularGraphMatchExpressionList.__ne__ ( object  expr)

Returns the result of the comparison operation self != expr.

Parameters
exprThe object instance to be compared with.
Returns
The result of the comparison operation.