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

expr	The 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_elem	The new size.
value	The 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_elem

The 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

array

The 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_elem	The number of elements to be assigned.
value	The value to be assigned.

addElement()

None CDPL.Chem.MolecularGraphMatchExpressionList.addElement

(

MolecularGraphMatchExpression

value

)

Inserts a new element at the end of the list.

Parameters

value

The 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

idx	The location where to insert the new element.
value	The value of the element to insert.

Exceptions

Base.IndexError

if 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

idx	The location where to insert the new elements.
num_elem	The number of elements to insert.
value	The value of the elements to insert.

Exceptions

Base.IndexError

if 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.OperationFailed

if the list is empty.

removeElement()

None CDPL.Chem.MolecularGraphMatchExpressionList.removeElement

(

int

idx

)

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

Parameters

idx	The zero-based index of the element to remove.

Exceptions

Base.IndexError

if 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.OperationFailed

if 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.OperationFailed

if 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

idx	The zero-based index of the element.

Returns

A reference to the element.

Exceptions

Base.IndexError

if 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

idx	The zero-based index of the element for which to assign a new value.
value	The new value of the element after assignment.

Exceptions

Base.IndexError

if 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

expr	The 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

expr	The object instance to be compared with.

Returns

The result of the comparison operation.