com.caoccao.javet.utils

Class ListUtils

java.lang.Object

com.caoccao.javet.utils.ListUtils

public final class ListUtils
extends java.lang.Object

The type List utils.

Since:

3.0.3

Method Summary

Modifier and Type	Method and Description
static <T> int	addAll(java.util.List<T> list, java.lang.Object array) Add all items from the array to the list.
static <T> void	flat(java.util.List<T> targetList, java.util.List<T> sourceList, int depth) The flat() method of Array instances creates a new array with all sub-array elements concatenated into it recursively up to the specified depth.
static <T> boolean	includes(java.util.List<T> list, T element, int fromIndex) The includes() method of Array instances determines whether an array includes a certain value among its entries, returning true or false as appropriate.
static <T> int	indexOf(java.util.List<T> list, T element, int fromIndex) The indexOf() method of Array instances returns the first index at which a given element can be found in the array, or -1 if it is not present.
static boolean	isEmpty(java.util.List<?> list) Is empty.
static boolean	isNotEmpty(java.util.List<?> list) Is not empty.
static <T> int	lastIndexOf(java.util.List<T> list, T element, int fromIndex) The lastIndexOf() method of Array instances returns the last index at which a given element can be found in the array, or -1 if it is not present.
static <T> T	pop(java.util.List<T> list) The pop() method of Array instances removes the last element from an array and returns that element.
static <T> int	push(java.util.List<T> list, T... elements) The push() method of Array instances adds the specified elements to the end of an array and returns the new length of the array.
static <T> T	shift(java.util.List<T> list) The shift() method of Array instances removes the first element from an array and returns that removed element.
static <T> int	unshift(java.util.List<T> list, T... elements) The unshift() method of Array instances adds the specified elements to the beginning of an array and returns the new length of the array.

Methods inherited from class java.lang.Object

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

Method Detail

addAll

public static <T> int addAll(java.util.List<T> list,
                             java.lang.Object array)

Add all items from the array to the list.

Type Parameters:

T - the type parameter

Parameters:

list - the list

array - the array

Returns:

the length of the array

Since:

3.0.4

flat

public static <T> void flat(java.util.List<T> targetList,
                            java.util.List<T> sourceList,
                            int depth)

The flat() method of Array instances creates a new array with all sub-array elements concatenated into it recursively up to the specified depth.

Type Parameters:

T - the type parameter

Parameters:

targetList - the target list

sourceList - the source list

depth - the depth

Since:

3.0.4

includes

public static <T> boolean includes(java.util.List<T> list,
                                   T element,
                                   int fromIndex)

The includes() method of Array instances determines whether an array includes a certain value among its entries, returning true or false as appropriate.

Type Parameters:

T - the type parameter

Parameters:

list - the list

element - the element

fromIndex - the from index

Returns:

true : included, false : not included

Since:

3.0.3

indexOf

public static <T> int indexOf(java.util.List<T> list,
                              T element,
                              int fromIndex)

The indexOf() method of Array instances returns the first index at which a given element can be found in the array, or -1 if it is not present.

Type Parameters:

T - the type parameter

Parameters:

list - the list

element - the element

fromIndex - the from index

Returns:

the index

Since:

3.0.3

isEmpty

public static boolean isEmpty(java.util.List<?> list)

Is empty.

Parameters:

list - the list

Returns:

true : empty, false : not empty

Since:

3.0.4

isNotEmpty

public static boolean isNotEmpty(java.util.List<?> list)

Is not empty.

Parameters:

list - the list

Returns:

true : not empty, false : empty

Since:

3.0.4

lastIndexOf

public static <T> int lastIndexOf(java.util.List<T> list,
                                  T element,
                                  int fromIndex)

The lastIndexOf() method of Array instances returns the last index at which a given element can be found in the array, or -1 if it is not present. The array is searched backwards, starting at fromIndex.

Type Parameters:

T - the type parameter

Parameters:

list - the list

element - the element

fromIndex - the from index

Returns:

the index

Since:

3.0.3

pop

public static <T> T pop(java.util.List<T> list)

The pop() method of Array instances removes the last element from an array and returns that element. This method changes the length of the array.

Type Parameters:

T - the type parameter

Parameters:

list - the list

Returns:

the removed element

Since:

3.0.3

push

public static <T> int push(java.util.List<T> list,
                           T... elements)

The push() method of Array instances adds the specified elements to the end of an array and returns the new length of the array.

Type Parameters:

T - the type parameter

Parameters:

list - the list

elements - the elements

Returns:

the new length of the array

Since:

3.0.3

shift

public static <T> T shift(java.util.List<T> list)

The shift() method of Array instances removes the first element from an array and returns that removed element. This method changes the length of the array.

Type Parameters:

T - the type parameter

Parameters:

list - the list

Returns:

the removed element

unshift

public static <T> int unshift(java.util.List<T> list,
                              T... elements)

The unshift() method of Array instances adds the specified elements to the beginning of an array and returns the new length of the array.

Type Parameters:

T - the type parameter

Parameters:

list - the list

elements - the elements

Returns:

the new length of the array