Memory-efficient immutable unit vector with element values of type unsigned long. More...

Inheritance diagram for CDPL.Math.ULUnitVector:

Public Member Functions
None	__init__ ()
	Constructs an empty unit vector (size zero, index zero).

None	__init__ (ULUnitVector v)
	Constructs a copy of the unit vector v. More...

None	__init__ (int n, int i)
	Constructs a unit vector of size n with the 1 element at index i. More...

None	resize (int n)
	Resizes the logical element count to n. More...

int	getIndex ()

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

bool	isEmpty ()
	Tells whether the vector has zero logical size. More...

int	getSize ()
	Returns the logical element count. More...

int	getElement (int i)
	Returns the element at index i. More...

object	toArray ()
	Converts the `ULUnitVector` instance into a corresponding `numpy.ndarray` object. More...

ULUnitVector	assign (ULUnitVector v)
	Copy-assigns the size and unit index from v. More...

None	swap (ULUnitVector v)
	Swaps the size and unit index with v. More...

bool	__eq__ (ULUnitVector v)
	Returns the result of the comparison operation `self == v`. More...

bool	__eq__ (ConstULVectorExpression e)
	Returns the result of the comparison operation `self == e`. More...

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

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

int	__call__ (int i)
	Returns the element at index i. More...

int	__getitem__ (int i)
	Returns the element at index i. More...

int	__len__ ()
	Returns the logical element count. More...

str	__str__ ()
	Returns a string representation of the `ULUnitVector` instance. More...

ULUnitVector	__pos__ ()
	Returns self. More...

ConstULVectorExpression	__neg__ ()
	Returns the result of the operation `self * -1`. More...

ConstULVectorExpression	__add__ (ConstULVectorExpression e)
	Returns the result of the addition operation `self + e`. More...

ConstULVectorExpression	__sub__ (ConstULVectorExpression e)
	Returns the result of the subtraction operation `self - e`. More...

ConstULVectorExpression	__mul__ (int t)
	Returns the result of the multiplication operation `self * t`. More...

ConstULVectorExpression	__mul__ (ConstULMatrixExpression e)
	Returns the result of the multiplication operation `self * e`. More...

ConstULVectorExpression	__div__ (int t)
	Returns the result of the division operation `self // t`. More...

ConstULVectorExpression	__truediv__ (int t)
	Returns the result of the true division operation `self / t`. More...

ConstULVectorExpression	__rmul__ (int t)
	Returns the result of the multiplication operation `t * self`. More...

Properties
	index = property(getIndex)

	objectID = property(getObjectID)

	size = property(getSize)

Detailed Description

Memory-efficient immutable unit vector with element values of type unsigned long.

Constructor & Destructor Documentation

◆ init() [1/2]

None CDPL.Math.ULUnitVector.__init__ ( ULUnitVector v )

Constructs a copy of the unit vector v.

Parameters

v	The unit vector to copy.

◆ init() [2/2]

None CDPL.Math.ULUnitVector.__init__	(	int	n,
		int	i
	)

Constructs a unit vector of size n with the 1 element at index i.

Parameters

n	The element count.
i	The zero-based index of the non-zero element.

Member Function Documentation

◆ resize()

None CDPL.Math.ULUnitVector.resize ( int n )

Resizes the logical element count to n.

Parameters

n	The new element count.

◆ getObjectID()

int CDPL.Math.ULUnitVector.getObjectID ( )

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

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

◆ isEmpty()

bool CDPL.Math.ULUnitVector.isEmpty ( )

Tells whether the vector has zero logical size.

Returns: True if the logical size is zero, and False otherwise.

◆ getSize()

int CDPL.Math.ULUnitVector.getSize ( )

Returns the logical element count.

Returns: The element count.

◆ getElement()

int CDPL.Math.ULUnitVector.getElement ( int i )

Returns the element at index i.

Parameters

i	The zero-based element index.

Returns: A reference to either 1 (if i equals the unit index) or 0.

Exceptions

Base.IndexError if i is out of range.

◆ toArray()

object CDPL.Math.ULUnitVector.toArray ( )

Converts the ULUnitVector instance into a corresponding numpy.ndarray object.

Returns: The generated numpy.ndarray object.

See also: [NUMPY]

◆ assign()

ULUnitVector CDPL.Math.ULUnitVector.assign ( ULUnitVector v )

Copy-assigns the size and unit index from v.

Parameters

v	The source unit vector.

Returns: self.

◆ swap()

None CDPL.Math.ULUnitVector.swap ( ULUnitVector v )

Swaps the size and unit index with v.

Parameters

v	The unit vector to swap with.

◆ eq() [1/2]

bool CDPL.Math.ULUnitVector.__eq__ ( ULUnitVector v )

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

Parameters

v	The `ULUnitVector` instance to be compared with.

Returns: The result of the comparison operation.

◆ eq() [2/2]

bool CDPL.Math.ULUnitVector.__eq__ ( ConstULVectorExpression e )

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

Parameters

e	The `ConstULVectorExpression` instance to be compared with.

Returns: The result of the comparison operation.

◆ ne() [1/2]

bool CDPL.Math.ULUnitVector.__ne__ ( ULUnitVector v )

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

Parameters

v	The `ULUnitVector` instance to be compared with.

Returns: The result of the comparison operation.

◆ ne() [2/2]

bool CDPL.Math.ULUnitVector.__ne__ ( ConstULVectorExpression e )

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

Parameters

e	The `ConstULVectorExpression` instance to be compared with.

Returns: The result of the comparison operation.

◆ call()

int CDPL.Math.ULUnitVector.__call__ ( int i )

Returns the element at index i.

Parameters

i	The zero-based element index.

Returns: A reference to either 1 (if i equals the unit index) or 0.

Exceptions

Base.IndexError if i is out of range.

◆ getitem()

int CDPL.Math.ULUnitVector.__getitem__ ( int i )

Returns the element at index i.

Parameters

i	The zero-based element index.

Returns: A reference to either 1 (if i equals the unit index) or 0.

Exceptions

Base.IndexError if i is out of range.

◆ len()

int CDPL.Math.ULUnitVector.__len__ ( )

Returns the logical element count.

Returns: The element count.

◆ str()

str CDPL.Math.ULUnitVector.__str__ ( )

Returns a string representation of the ULUnitVector instance.

Returns: The generated string representation.

◆ pos()

ULUnitVector CDPL.Math.ULUnitVector.__pos__ ( )

Returns self.

Returns: self.

◆ neg()

ConstULVectorExpression CDPL.Math.ULUnitVector.__neg__ ( )

Returns the result of the operation self * -1.

Returns: A ConstULVectorExpression instance holding the result of the element negation.

◆ add()

ConstULVectorExpression CDPL.Math.ULUnitVector.__add__ ( ConstULVectorExpression e )

Returns the result of the addition operation self + e.

Parameters

e	Specifies the second addend.

Returns: A ConstULVectorExpression instance holding the result of the addition.

◆ sub()

ConstULVectorExpression CDPL.Math.ULUnitVector.__sub__ ( ConstULVectorExpression e )

Returns the result of the subtraction operation self - e.

Parameters

e	Specifies the subtrahend.

Returns: A ULUnitVector instance holding the result of the subtraction.

◆ mul() [1/2]

ConstULVectorExpression CDPL.Math.ULUnitVector.__mul__ ( int t )

Returns the result of the multiplication operation self * t.

Parameters

t	Specifies the multiplier.

Returns: A ConstULVectorExpression instance holding the result of the multiplication.

◆ mul() [2/2]

ConstULVectorExpression CDPL.Math.ULUnitVector.__mul__ ( ConstULMatrixExpression e )

Returns the result of the multiplication operation self * e.

Parameters

e	Specifies the multiplier.

Returns: A ConstULVectorExpression instance holding the result of the multiplication.

◆ div()

ConstULVectorExpression CDPL.Math.ULUnitVector.__div__ ( int t )

Returns the result of the division operation self // t.

Parameters

t	Specifies the divisor.

Returns: A ConstULVectorExpression instance holding the result of the division.

◆ truediv()

ConstULVectorExpression CDPL.Math.ULUnitVector.__truediv__ ( int t )

Returns the result of the true division operation self / t.

Parameters

t	Specifies the divisor.

Returns: A ConstULVectorExpression instance holding the result of the division.

◆ rmul()

ConstULVectorExpression CDPL.Math.ULUnitVector.__rmul__ ( int t )

Returns the result of the multiplication operation t * self.

Parameters

t	Specifies the multiplicand.

Returns: A ConstULVectorExpression instance holding the result of the multiplication.

Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ __init__() [1/2]

◆ __init__() [2/2]

Member Function Documentation

◆ resize()

◆ getObjectID()

◆ isEmpty()

◆ getSize()

◆ getElement()

◆ toArray()

◆ assign()

◆ swap()

◆ __eq__() [1/2]

◆ __eq__() [2/2]

◆ __ne__() [1/2]

◆ __ne__() [2/2]

◆ __call__()

◆ __getitem__()

◆ __len__()

◆ __str__()

◆ __pos__()

◆ __neg__()

◆ __add__()

◆ __sub__()

◆ __mul__() [1/2]

◆ __mul__() [2/2]

◆ __div__()

◆ __truediv__()

◆ __rmul__()

◆ init() [1/2]

◆ init() [2/2]

◆ eq() [1/2]

◆ eq() [2/2]

◆ ne() [1/2]

◆ ne() [2/2]

◆ call()

◆ getitem()

◆ len()

◆ str()

◆ pos()

◆ neg()

◆ add()

◆ sub()

◆ mul() [1/2]

◆ mul() [2/2]

◆ div()

◆ truediv()

◆ rmul()