Package org.openrewrite.internal

Class ListUtils

java.lang.Object

org.openrewrite.internal.ListUtils

public final class ListUtils
extends Object

Method Summary

Modifier and Type	Method	Description
static <T> T @Nullable []	arrayOrNullIfEmpty(@Nullable List<T> list, T[] array)
static <T> List<T>	concat(@Nullable List<T> ls, T t)
static <T> List<T>	concat(T t, @Nullable List<T> ls)
static <T> List<T>	concatAll(@Nullable List<T> ls, @Nullable List<? extends T> t)
static <T> List<T>	flatMap(@Nullable List<T> ls, BiFunction<Integer,T,Object> flatMap)
static <T> List<T>	flatMap(@Nullable List<T> ls, Function<T,Object> flatMap)
static <T> List<T>	insert(@Nullable List<T> ls, T t, int index)	Insert element to a list at the specified position in the list.
static <T> List<T>	insertAll(@Nullable List<T> ls, int index, @Nullable List<T> t)
static <T> List<T>	insertInOrder(@Nullable List<T> ls, T insert, Comparator<T> naturalOrdering)	Insert into as-near of a location representing the natural ordering of the list without assuming the list is already sorted according to its natural ordering AND without changing the position of any other element.
static <T> List<T>	map(@Nullable List<T> ls, BiFunction<Integer,T,T> map)
static <T> List<T>	map(@Nullable List<T> ls, UnaryOperator<T> map)
static <T> List<T>	mapFirst(@Nullable List<T> ls, UnaryOperator<T> mapFirst)
static <T> List<T>	mapLast(@Nullable List<T> ls, UnaryOperator<T> mapLast)
static <T> @Nullable List<T>	nullIfEmpty(@Nullable List<T> ls)
static <T> T @Nullable []	nullIfEmpty(T @Nullable [] list)

Methods inherited from class java.lang.Object

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

Method Details

insertInOrder

public static <T> List<T> insertInOrder(@Nullable
 @Nullable List<T> ls,
 T insert,
 Comparator<T> naturalOrdering)

Insert into as-near of a location representing the natural ordering of the list without assuming the list is already sorted according to its natural ordering AND without changing the position of any other element. This provides a means of both inserting in a natural order but also making the least invasive change.

Type Parameters:

T - The type of elements in the list.

Parameters:

ls - The original list, which may not be ordered.

insert - The element to add.

naturalOrdering - The natural or idiomatic ordering of the list.

Returns:

A new list with the element inserted in an approximately ordered place.

insert

public static <T> List<T> insert(@Nullable
 @Nullable List<T> ls,
 @Nullable
 T t,
 int index)

Insert element to a list at the specified position in the list. Throws the same exceptions as List.add()

Type Parameters:

T - The type of elements in the list.

Parameters:

ls - The original list.

t - The element to add.

index - index at which the specified element is to be inserted

Returns:

A new list with the element inserted at the specified position.

mapLast

public static <T> List<T> mapLast(@Nullable
 @Nullable List<T> ls,
 UnaryOperator<T> mapLast)

mapFirst

public static <T> List<T> mapFirst(@Nullable
 @Nullable List<T> ls,
 UnaryOperator<T> mapFirst)

map

public static <T> List<T> map(@Nullable
 @Nullable List<T> ls,
 BiFunction<Integer,T,T> map)

map

public static <T> List<T> map(@Nullable
 @Nullable List<T> ls,
 UnaryOperator<T> map)

flatMap

public static <T> List<T> flatMap(@Nullable
 @Nullable List<T> ls,
 BiFunction<Integer,T,Object> flatMap)

flatMap

public static <T> List<T> flatMap(@Nullable
 @Nullable List<T> ls,
 Function<T,Object> flatMap)

concat

public static <T> List<T> concat(@Nullable
 @Nullable List<T> ls,
 @Nullable
 T t)

concat

public static <T> List<T> concat(@Nullable
 T t,
 @Nullable
 @Nullable List<T> ls)

concatAll

public static <T> List<T> concatAll(@Nullable
 @Nullable List<T> ls,
 @Nullable
 @Nullable List<? extends T> t)

insertAll

public static <T> List<T> insertAll(@Nullable
 @Nullable List<T> ls,
 int index,
 @Nullable
 @Nullable List<T> t)

nullIfEmpty

@Nullable
public static <T> @Nullable List<T> nullIfEmpty(@Nullable
 @Nullable List<T> ls)

arrayOrNullIfEmpty

public static <T> T @Nullable [] arrayOrNullIfEmpty(@Nullable
 @Nullable List<T> list,
 T[] array)

nullIfEmpty

public static <T> T @Nullable [] nullIfEmpty(T @Nullable [] list)