HxArray Class

class hexaly.optimizer.HxArray

Value type for array expressions.

Such a value is obtained with HxExpression.value when the expression is an array. An array can contain numbers (int, double), other HxArray (for multi-dimensional arrays), HxInterval or HxCollection (list, set).

Arrays are not decisions and cannot be modified.

Since:

7.5

See:

HxModel

See:

HxExpression

See:

HxOperator.ARRAY

Summary

Methods

count

Returns the number of values in the collection.

is_bool

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

is_int

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

is_double

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

is_interval

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

is_array

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

is_collection

Returns true if the value at the given position is a collection (list or set).

is_undefined

If an argument is passed to the function, returns true if the value at the given position is undefined, otherwise returns true if the array itself is undefined.

get

Gets the value at the given position.

Special methods

__str__

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

__getitem__

Operator overloading for HxArray.get().

__len__

Returns the length of the array (same result as HxArray.count()).

__iter__

Returns an iterator for the content of this array.

Instance methods

HxArray.count()

Returns the number of values in the collection. Elements in arrays are indexed from 0 to count()-1.

Returns:

Number of values in this HxCollection

Return type:

int

HxArray.is_bool(pos)

Returns true if the value at the given position is a boolean. You can retrieve the value with get() or with the special overloaded operator __getitem__().

Parameters:

pos (int) – Position of the value to query.

Returns:

True if the value at the given position is a boolean.

Return type:

bool

HxArray.is_int(pos)

Returns true if the value at the given position is an integer. You can retrieve the value with get() or with the special overloaded operator __getitem__().

Parameters:

pos (int) – Position of the value to query.

Returns:

True if the value at the given position is an integer.

Return type:

bool

HxArray.is_double(pos)

Returns true if the value at the given position is a double. You can retrieve the value with get() or with the special overloaded operator __getitem__().

Parameters:

pos (int) – Position of the value to query.

Returns:

True if the value at the given position is a double.

Return type:

bool

HxArray.is_interval(pos)

Returns true if the value at the given position is an interval. You can retrieve the value with get() or with the special overloaded operator __getitem__().

Parameters:

pos (int) – Position of the value to query.

Returns:

True if the value at the given position is an interval.

Return type:

bool

HxArray.is_array(pos)

Returns true if the value at the given position is an array. You can retrieve the value with get() or with the special overloaded operator __getitem__().

Parameters:

pos (int) – Position of the value to query.

Returns:

True if the value at the given position is an array.

Return type:

bool

HxArray.is_collection(pos)

Returns true if the value at the given position is a collection (list or set). You can retrieve the value with get() or with the special overloaded operator __getitem__().

Parameters:

pos (int) – Position of the value to query.

Returns:

True if the value at the given position is a collection.

Return type:

bool

HxArray.is_undefined(pos)
HxArray.is_undefined()

If an argument is passed to the function, returns true if the value at the given position is undefined, otherwise returns true if the array itself is undefined. A value can be undefined in 4 cases:

  • It is a double and its value is NaN (Not a Number).

  • It is an integer or boolean with no valid value (arithmetic or out of bounds exception).

  • It is an interval with at least one undefined bound.

  • It is the result of any ill-defined operation (at with out of bounds index or operations on undefined values for instance).

Parameters:

pos (int) – Position of the value to query.

Returns:

True if the value at the given position is undefined, or if the array is undefined if no argument is passed.

Return type:

bool

HxArray.get(pos)

Gets the value at the given position. The type of the returned value can be a boolean, an integer, a double, a HxInterval, a HxArray or a HxCollection.

Parameters:

pos (int) – Position of the value to query.

Returns:

Value at the given position

Return type:

bool, int, double, HxInterval, HxArray or HxCollection.

Special operators and methods

HxArray.__str__()

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

Returns:

String representation of this array.

Return type:

str

HxArray.__getitem__(pos)

Operator overloading for HxArray.get().

HxArray.__len__()

Returns the length of the array (same result as HxArray.count()).

HxArray.__iter__()

Returns an iterator for the content of this array.