LocalSolver logo
is now
Hexaly logo

We're excited to share that we are moving forward. We're leaving behind the LocalSolver brand and transitioning to our new identity: Hexaly. This represents a leap forward in our mission to enable every organization to make better decisions faster when faced with operational and strategic challenges.

This page is for an old version of Hexaly Optimizer. We recommend that you update your version and read the documentation for the latest stable release.

LSArray Class

class localsolver::LSArray

Value type for array expressions.

Such value is obtained with LSExpression::getArrayValue() or LSSolution::getArrayValue(const LSExpression). An array contains values of type lsint, lsdouble or LSArray (for multi-dimensional arrays). Note that it’s possible to mix integers or doubles in the same array.

Arrays are not decisions and cannot be modified.

See:LSSolution
See:LSExpression
Since:7.5

Summary

Functions
count Returns the number of elements in the array.
isBool Returns true if the value at the given position is a boolean.
isInt Returns true if the value at the given position is an integer.
isDouble Returns true if the value at the given position is a double.
isArray Returns true if the value at the given position is an array.
getIntValue Returns the integer value at the given position.
getDoubleValue Returns the double value at the given position.
getArrayValue Returns the array value at the given position.
toString Returns a string representation of the values in the array in the format “{ val0, val1, .

Functions

int count() const

Returns the number of elements in the array.

Elements in arrays are indexed from 0 to count()-1.

bool isBool(int pos) const

Returns true if the value at the given position is a boolean.

You can retrieve the value with getIntValue.

Return:True if the value at the given position is a boolean.
Parameters:pos - Position of the value to query.

bool isInt(int pos) const

Returns true if the value at the given position is an integer.

You can retrieve the value with getIntValue.

Return:True if the value at the given position is an integer.
Parameters:pos - Position of the value to query.

bool isDouble(int pos) const

Returns true if the value at the given position is a double.

You can retrieve the value with getDoubleValue.

Return:True if the value at the given position is a double.
Parameters:pos - Position of the value to query.

bool isArray(int pos) const

Returns true if the value at the given position is an array.

You can retrieve the value with getArrayValue.

Return:True if the value at the given position is an array.
Parameters:pos - Position of the value to query.

lsint getIntValue(int pos) const

Returns the integer value at the given position.

If the value is neither an integer nor a boolean, an exception is thrown.

Return:Integer value.
Parameters:pos - Position of the value to query.

lsdouble getDoubleValue(int pos) const

Returns the double value at the given position.

If the value is not a double, an exception is thrown.

Return:Double value.
Parameters:pos - Position of the value to query.

LSArray getArrayValue(int pos) const

Returns the array value at the given position.

If the value is not an array, an exception is thrown.

Return:Array value.
Parameters:pos - Position of the value to query.

std::string toString() const

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

Return:String representation.