An array of pairs of unsigned integers of type std::size_t. More...

Inheritance diagram for CDPL.Util.STPairArray:

Public Member Functions
None	__init__ ()
	Creates an empty array.

None	__init__ (STPairArray array)
	Initializes a copy of the STPairArray instance array. 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 array. More...

bool	isEmpty ()
	Tells whether the array is empty (getSize() == 0). More...

None	resize (int num_elem, STPair 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.

STPairArray	assign (STPairArray array)
	Replaces the current state of self with a copy of the state of the STPairArray instance array. More...

None	assign (int num_elem, STPair value)
	This function fills the array with num_elem copies of the given value. More...

None	addElement (STPair value)
	Inserts a new element at the end of the array. More...

None	addElements (STPairArray values)

None	insertElement (int idx, STPair value)
	Inserts a new element before the location specified by the index idx. More...

None	insertElements (int idx, int num_elem, STPair value)
	Inserts num_elem copies of value before the location specified by the index idx. More...

None	insertElements (int index, STPairArray values)

None	popLastElement ()
	Removes the last element of the array. 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)

STPair	getFirstElement ()
	Returns a reference to the first element of the array. More...

STPair	getLastElement ()
	Returns a reference to the last element of the array. More...

STPair	getElement (int idx)
	Returns a reference to the element at index idx. More...

None	setElement (int idx, STPair value)
	Assigns a new value to the element specified by the index idx. More...

None	__delitem__ (int idx)

STPair	__getitem__ (int idx)

int	__len__ ()

None	__setitem__ (int index, STPair value)

bool	__eq__ (STPairArray array)
	Returns the result of the comparison operation `self == array`. More...

bool	__ne__ (STPairArray array)
	Returns the result of the comparison operation `self != array`. More...

bool	__le__ (STPairArray array)
	Returns the result of the comparison operation `self <= array`. More...

bool	__ge__ (STPairArray array)
	Returns the result of the comparison operation `self >= array`. More...

bool	__lt__ (STPairArray array)
	Returns the result of the comparison operation `self < array`. More...

bool	__gt__ (STPairArray array)
	Returns the result of the comparison operation `self > array`. More...

Properties
	objectID = property(getObjectID)

	size = property(getSize)

Detailed Description

An array of pairs of unsigned integers of type std::size_t.

Constructor & Destructor Documentation

◆ init()

None CDPL.Util.STPairArray.__init__ ( STPairArray array )

Initializes a copy of the STPairArray instance array.

Parameters

array The STPairArray instance to copy.

Member Function Documentation

◆ getObjectID()

int CDPL.Util.STPairArray.getObjectID ( )

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

Different Python STPairArray 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 STPairArray 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.

◆ getSize()

int CDPL.Util.STPairArray.getSize ( )

Returns the number of elements stored in the array.

Returns: The size of the array.

◆ isEmpty()

bool CDPL.Util.STPairArray.isEmpty ( )

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

Returns: True if the array is empty, False otherwise.

◆ resize()

None CDPL.Util.STPairArray.resize	(	int	num_elem,
		STPair	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.Util.STPairArray.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.Util.STPairArray.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]

STPairArray CDPL.Util.STPairArray.assign ( STPairArray array )

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

Parameters

array The STPairArray instance to copy.

Returns: self

◆ assign() [2/2]

None CDPL.Util.STPairArray.assign	(	int	num_elem,
		STPair	value
	)

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

Note that the assignment completely changes the array 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.Util.STPairArray.addElement ( STPair value )

Inserts a new element at the end of the array.

Parameters

value The value of the new element.

◆ addElements()

None CDPL.Util.STPairArray.addElements ( STPairArray values )

Parameters

values

◆ insertElement()

None CDPL.Util.STPairArray.insertElement	(	int	idx,
		STPair	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 array is empty or idx is not in the range [0, getSize()].

◆ insertElements() [1/2]

None CDPL.Util.STPairArray.insertElements	(	int	idx,
		int	num_elem,
		STPair	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.Util.STPairArray.insertElements	(	int	index,
		STPairArray	values
	)

Parameters

index
values

◆ popLastElement()

None CDPL.Util.STPairArray.popLastElement ( )

Removes the last element of the array.

Exceptions

Base.OperationFailed if the array is empty.

◆ removeElement()

None CDPL.Util.STPairArray.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 array is empty or idx is not in the range [0, getSize() - 1].

◆ removeElements()

None CDPL.Util.STPairArray.removeElements	(	int	begin_idx,
		int	end_idx
	)

Parameters

begin_idx
end_idx

◆ getFirstElement()

STPair CDPL.Util.STPairArray.getFirstElement ( )

Returns a reference to the first element of the array.

Returns: A reference to the first element.

Exceptions

Base.OperationFailed if the array is empty.

◆ getLastElement()

STPair CDPL.Util.STPairArray.getLastElement ( )

Returns a reference to the last element of the array.

Returns: A reference to the last element.

Exceptions

Base.OperationFailed if the array is empty.

◆ getElement()

STPair CDPL.Util.STPairArray.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 array is empty or idx is not in the range [0, getSize() - 1].

◆ setElement()

None CDPL.Util.STPairArray.setElement	(	int	idx,
		STPair	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 array is empty or idx is not in the range [0, getSize() - 1].

◆ delitem()

None CDPL.Util.STPairArray.__delitem__ ( int idx )

Parameters

idx

◆ getitem()

STPair CDPL.Util.STPairArray.__getitem__ ( int idx )

Parameters

idx

Returns

◆ len()

int CDPL.Util.STPairArray.__len__ ( )

Returns

◆ setitem()

None CDPL.Util.STPairArray.__setitem__	(	int	index,
		STPair	value
	)

Parameters

index
value