Package com.peterphi.std.util

Class ListUtility

java.lang.Object

com.peterphi.std.util.ListUtility

public class ListUtility
extends Object

Constructor Summary

Constructors

Constructor	Description
ListUtility()

Method Summary

Modifier and Type	Method	Description
static <T> T[]	array(Iterable<T> itbl, T[] array)
static <T> List<T>	concat(Collection<? extends T>... lists)	Concatenates a number of Collections into a single List
static boolean	contains(String[] haystack, String needle)
static <T> boolean	contains(Collection<T> c, T o)
static <T> boolean	empty(Collection<T> c)
static boolean	empty(Map<?,?> m)
static char[]	flip(char[] src, char[] dest, int start, int length)	Reverses a character array
static int[]	flip(int[] src, int[] dest, int start, int length)	Reverses an integer array
static <T> List<T>	flip(List<T> src)	Reverses a list
static <T> List<T>	flip(List<T> src, List<T> dest, int start, int length)	Reverses a list
static <T> T[]	flip(T[] src)	Reverses an array
static <T> T[]	flip(T[] src, T[] dest, int start, int length)	Reverses an array
static <T> T	head(List<T> list)	Returns the first element of a list (or null if the list is empty)
static <T> HybridIterator<T>	iterate(Enumeration<T> items)
static <T> HybridIterator<T>	iterate(Iterator<T> items)
static <T> List<T>	join(Iterable<T>... items)
static <T> List<T>	last(List<T> src, int count)	Return, at most, the last n items from the source list
static <T> int	length(Collection<T> items)
static <T> int	length(T[] items)
static <T> List<T>	list(Iterable<T> iterable)	Converts an Iterable into a List
static <T> List<T>	list(List<T> items)
static <T> List<T>	list(T[] items)
static <T> int	size(Collection<T> items)
static <T> int	size(T[] items)
static <T> List<T>	tail(List<T> list)	Returns a sublist containing all the items in the list after the first
static <T> Set<T>	union(Collection<? extends T>... lists)	Concatenates a number of Collections into a single Set

Methods inherited from class java.lang.Object

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

Constructor Detail

ListUtility

public ListUtility()

Method Detail

list

public static <T> List<T> list(T[] items)

list

public static <T> List<T> list(List<T> items)

list

public static <T> List<T> list(Iterable<T> iterable)

Converts an Iterable into a List

Parameters:

iterable -

Returns:

array

public static <T> T[] array(Iterable<T> itbl,
                            T[] array)

last

public static <T> List<T> last(List<T> src,
                               int count)

Return, at most, the last n items from the source list

Type Parameters:

T - the list type

Parameters:

src - the source list

count - the maximum number of items

Returns:

the last n items from the src list; if the list is not of size n, the original list is copied and returned

head

public static <T> T head(List<T> list)

Returns the first element of a list (or null if the list is empty)

Parameters:

list -

Returns:

tail

public static <T> List<T> tail(List<T> list)

Returns a sublist containing all the items in the list after the first

Parameters:

list -

Returns:

flip

public static <T> T[] flip(T[] src,
                           T[] dest,
                           int start,
                           int length)

Reverses an array

Type Parameters:

T -

Parameters:

src -

dest -

start -

length -

Returns:

flip

public static <T> T[] flip(T[] src)

Reverses an array

Type Parameters:

T -

Parameters:

src -

Returns:

flip

public static <T> List<T> flip(List<T> src,
                               List<T> dest,
                               int start,
                               int length)

Reverses a list

Type Parameters:

T -

Parameters:

src -

dest -

start -

length -

Returns:

flip

public static <T> List<T> flip(List<T> src)

Reverses a list

Type Parameters:

T -

Parameters:

src -

Returns:

flip

public static int[] flip(int[] src,
                         int[] dest,
                         int start,
                         int length)

Reverses an integer array

Parameters:

src -

dest -

start -

length -

Returns:

flip

public static char[] flip(char[] src,
                          char[] dest,
                          int start,
                          int length)

Reverses a character array

Parameters:

src -

dest -

start -

length -

Returns:

iterate

public static <T> HybridIterator<T> iterate(Iterator<T> items)

iterate

public static <T> HybridIterator<T> iterate(Enumeration<T> items)

size

public static <T> int size(T[] items)

size

public static <T> int size(Collection<T> items)

length

public static <T> int length(T[] items)

length

public static <T> int length(Collection<T> items)

empty

public static boolean empty(Map<?,?> m)

empty

public static <T> boolean empty(Collection<T> c)

contains

public static <T> boolean contains(Collection<T> c,
                                   T o)

contains

public static boolean contains(String[] haystack,
                               String needle)

concat

public static <T> List<T> concat(Collection<? extends T>... lists)

Concatenates a number of Collections into a single List

Type Parameters:

T -

Parameters:

lists -

Returns:

union

public static <T> Set<T> union(Collection<? extends T>... lists)

Concatenates a number of Collections into a single Set

Type Parameters:

T -

Parameters:

lists -

Returns:

join

public static <T> List<T> join(Iterable<T>... items)