LSCollection Class¶

class LSCollection¶

Value type for collection expressions (lists or sets). Such value is obtained with LSExpression::getCollectionValue() or LSSolution::getCollectionValue(). It represents a reference to the value of a variable and the value of this variable is modified when the LSCollection object is modified.

See:	LSSolution
See:	LSExpression
Since:	5.5

Summary¶

Functions¶
`add`	Adds the given value to this collection.
`clear`	Removes all values of this collection.
`count`	Returns the number of values in the collection.
`get`	Gets the value at the given position.
`contains`	Returns true if the collection contains the given value, false otherwise.
`toString`	Returns a string representation of the values in the collection in the format { val0, val1, ..., valN }.

Overloaded operators¶
`operator[]`	Operator overloading for get.

Functions¶

void LSCollection::add(lsint val)¶

Adds the given value to this collection. Only allowed in state S_Stopped. This function will fail if the given value is outside of the domain of the list/set or if this value is already included in this list/set (keep in mind that a list or a set cannot contain twice the same value).

Parameters:	val – The value to be added.

void LSCollection::clear()¶: Removes all values of this collection. Only allowed in state S_Stopped.

int LSCollection::count() const¶: Returns the number of values in the collection. Values in collections are indexed from 0 to count()-1.

lsint LSCollection::get(int position) const¶

Gets the value at the given position.

Parameters:	position – The considered position (must be non negative and strictly smaller than the number of values in the collection).

bool LSCollection::contains(lsint value) const¶

Returns true if the collection contains the given value, false otherwise.

Parameters:	value – element whose presence in this collection is to be tested

std::string LSCollection::toString() const¶

Returns a string representation of the values in the collection in the format { val0, val1, ..., valN }.

Returns:	String representation.

Overloaded operators¶

lsint LSCollection::operator[](int position) const¶

Operator overloading for get.

Parameters:	position – The considered position (must be non negative and strictly smaller than the number of values in the collection).