bsh

Class BshArray

java.lang.Object

bsh.BshArray

public class BshArray
extends java.lang.Object

Collection of array manipulation functions.

Method Summary

Modifier and Type	Method and Description
static java.lang.Class<?>	commonType(java.lang.Class<?> baseType, java.lang.Object fromValue, java.util.function.IntSupplier length) Find a more specific type if the element type is Object.class.
static java.lang.Object	concat(java.util.List<?> lhs, java.util.List<?> rhs) Concatenate two lists.
static java.lang.Object	concat(java.lang.Object lhs, java.lang.Object rhs) Concatenate two arrays.
static int[]	dimensions(java.lang.Object arr) Collect dimensions array of supplied array object.
static java.lang.Object	getIndex(java.lang.Object array, int index) Get object from array or list at index.
static java.lang.Object	repeat(java.util.List<java.lang.Object> list, int times) Repeat the contents of a list a number of times.
static java.lang.Object	repeat(java.lang.Object arr, int times) Repeat the contents of an array a number of times.
static void	setIndex(java.lang.Object array, int index, java.lang.Object val) Set element value of array or list at index.
static java.lang.Object	slice(java.util.List<java.lang.Object> list, int from, int to, int step) Slice the supplied list for range and step.
static java.lang.Object	slice(java.lang.Object arr, int from, int to, int step) Slice the supplied array for range and step.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getIndex

public static java.lang.Object getIndex(java.lang.Object array,
                                        int index)
                                 throws UtilTargetError

Get object from array or list at index.

Parameters:

array - to retrieve from

index - of the element to retrieve

Returns:

Array.get for array or List.get for list

Throws:

UtilTargetError - wrapped Index out of bounds

setIndex

public static void setIndex(java.lang.Object array,
                            int index,
                            java.lang.Object val)
                     throws bsh.ReflectError,
                            UtilTargetError

Set element value of array or list at index. Array.set for array or List.set for list.

Parameters:

array - to set value for.

index - of the element to set

val - the value to set

Throws:

UtilTargetError - wrapped target exceptions

bsh.ReflectError

slice

public static java.lang.Object slice(java.util.List<java.lang.Object> list,
                                     int from,
                                     int to,
                                     int step)

Slice the supplied list for range and step.

Parameters:

list - to slice

from - start index inclusive

to - to index exclusive

step - size of step or 0 if no step

Returns:

a sliced view of the supplied list

slice

public static java.lang.Object slice(java.lang.Object arr,
                                     int from,
                                     int to,
                                     int step)

Slice the supplied array for range and step.

Parameters:

arr - to slice

from - start index inclusive

to - to index exclusive

step - size of step or 0 if no step

Returns:

a new array instance sliced

repeat

public static java.lang.Object repeat(java.util.List<java.lang.Object> list,
                                      int times)

Repeat the contents of a list a number of times.

Parameters:

list - the list to repeat

times - number of repetitions

Returns:

a new list instance with repeated contents

repeat

public static java.lang.Object repeat(java.lang.Object arr,
                                      int times)

Repeat the contents of an array a number of times.

Parameters:

arr - the array object to repeat

times - number of repetitions

Returns:

a new array instance with repeated contents

concat

public static java.lang.Object concat(java.util.List<?> lhs,
                                      java.util.List<?> rhs)

Concatenate two lists.

Parameters:

lhs - 1st list

rhs - 2nd list

Returns:

a new list instance of concatenated contents.

concat

public static java.lang.Object concat(java.lang.Object lhs,
                                      java.lang.Object rhs)
                               throws UtilEvalError

Concatenate two arrays.

Parameters:

lhs - 1st array

rhs - 2nd array

Returns:

a new array instance of concatenated contents.

Throws:

UtilEvalError - for inconsistent dimensions.

dimensions

public static int[] dimensions(java.lang.Object arr)

Collect dimensions array of supplied array object. Returns the integer array used for Array.newInstance.

Parameters:

arr - to inspect

Returns:

int array of dimensions

commonType

public static java.lang.Class<?> commonType(java.lang.Class<?> baseType,
                                            java.lang.Object fromValue,
                                            java.util.function.IntSupplier length)

Find a more specific type if the element type is Object.class.

Parameters:

baseType - the element type

fromValue - the array to inspect

length - the length of the array

Returns:

baseType unless baseType is Object.class and common is not