Package com.storedobject.common

Class StringList

java.lang.Object

com.storedobject.common.StringList

All Implemented Interfaces:

Iterable<String>, Collection<String>, List<String>, SequencedCollection<String>

public class StringList
extends Object
implements Iterable<String>, List<String>

A class to keep a list of Strings. This class is immutable.

Author:

Syam

Field Summary

Fields

Modifier and Type	Field	Description
static final StringList	EMPTY

Method Summary

Modifier and Type	Method	Description
void	add(int index, String element)
boolean	add(String e)
boolean	addAll(int index, Collection<? extends String> c)
boolean	addAll(Collection<? extends String> c)
String[]	array()	Get a copy of the elements as an array.
void	clear()
StringList	concat(StringList another)	Concatenate another list to this list.
static StringList	concat(StringList... lists)	Concatenate an array of lists.
static StringList	concat(StringList first, StringList second)	Concatenate 2 lists..
StringList	concat(String[] another)	Concatenate another list to this list.
static StringList	concat(String[]... lists)	Concatenate an array of lists.
StringList	concat(Collection<String> collection)	Concatenate a collection to this list.
boolean	contains(Object o)
boolean	contains(String element)	Check whether this list contains the given element or not.
boolean	contains(String element, int from)	Check whether this list contains the given element or not.
boolean	contains(String element, int from, int to)	Check whether this list contains the given element or not.
boolean	contains(Predicate<String> filter)	Check whether this list contains any element that matches a given predicate or not.
boolean	contains(Predicate<String> filter, int from)	Check whether this list contains any element that matches a given predicate or not.
boolean	contains(Predicate<String> filter, int from, int to)	Check whether this list contains any element that matches a given predicate or not.
boolean	containsAll(Collection<?> c)
int	copyTo(int startingIndex, int count, String[] buffer)	Copy the elements of this list to a buffer.
int	copyTo(int startingIndex, int count, String[] buffer, int startingBufferIndex)	Copy the elements of this list to a buffer.
int	copyTo(int startingIndex, String[] buffer)	Copy the elements of this list to a buffer.
int	copyTo(int startingIndex, String[] buffer, int startingBufferIndex, int count)	Copy the elements of this list to a buffer.
int	copyTo(String[] buffer)	Copy the elements of this list to a buffer.
int	copyTo(String[] buffer, int startingBufferIndex)	Copy the elements of this list to a buffer.
int	copyTo(String[] buffer, int startingBufferIndex, int count)	Copy the elements of this list to a buffer.
static StringList	create(StringList... list)	Create a string list by concatenating one or more lists.
static StringList	create(Iterable<String> list)	Create a string list from an Iterable.
static StringList	create(String list)	Create a string list.
static StringList	create(String... array)	Create a string list from an array of strings..
static StringList	create(Collection<String> collection)	Create a string list from a collection.
static StringList	create(Iterator<String> list)	Create a string list from an Iterator.
boolean	equals(Object o)
String	get(int index)
int	hashCode()
int	indexOf(Object o)
int	indexOf(String element)	Index of an element in the list.
int	indexOf(String element, int from)	Index of an element in the list.
int	indexOf(String element, int from, int to)	Index of an element in the list.
int	indexOf(Predicate<String> filter)	Returns the index of the first occurrence of an element in the list that satisfies the given filter.
int	indexOf(Predicate<String> filter, boolean unique)	Index of an element in the list that matches the given predicate.
int	indexOf(Predicate<String> filter, boolean unique, int from)	Index of an element in the list that matches the given predicate.
int	indexOf(Predicate<String> filter, boolean unique, int from, int to)	Index of an element in the list that matches the given predicate.
int	indexOf(Predicate<String> filter, int from)	Returns the index of the first element that matches the given predicate starting from the specified index.
int	indexOf(Predicate<String> filter, int from, int to)	Index of an element in the list that matches the given predicate.
boolean	isEmpty()
Iterator<String>	iterator()
int	lastIndexOf(Object o)
ListIterator<String>	listIterator()
ListIterator<String>	listIterator(int index)
StringList	map(Function<String,String> converter)	Create another instance by mapping the elements of this list via a converter function.
StringList	minus(StringList another)	Remove elements from this list that are elements of another list.
String	remove(int index)
boolean	remove(Object o)
StringList	remove(String element)	Remove an element from the list.
boolean	removeAll(Collection<?> c)
boolean	retainAll(Collection<?> c)
String	set(int index, String element)
int	size()
Stream<String>	stream()	Stream the elements.
StringList	subList(int index)	Get a sub-list.
StringList	subList(int start, int end)	Get a sub-list.
Object[]	toArray()
<T> T[]	toArray(T[] a)
String	toString()
String	toString(String delimiter)	Concatenate the elements of this list into a String with the given delimiter.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, removeIf, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

addFirst, addLast, getFirst, getLast, removeFirst, removeLast, replaceAll, reversed, sort, spliterator

Field Details

EMPTY

public static final StringList EMPTY

Method Details

create

public static StringList create(String list)

Create a string list.

Parameters:

list - Comma delimited list.

Returns:

String list created.

create

public static StringList create(Collection<String> collection)

Create a string list from a collection.

Parameters:

collection - Collection.

Returns:

String list created.

create

public static StringList create(Iterable<String> list)

Create a string list from an Iterable.

Parameters:

list - Iterable.

Returns:

String list created.

create

public static StringList create(Iterator<String> list)

Create a string list from an Iterator.

Parameters:

list - Iterator.

Returns:

String list created.

create

public static StringList create(String... array)

Create a string list from an array of strings..

Parameters:

array - Array of strings.

Returns:

String list created.

create

public static StringList create(StringList... list)

Create a string list by concatenating one or more lists.

Parameters:

list - Lists.

Returns:

String list created.

map

public StringList map(Function<String,String> converter)

Create another instance by mapping the elements of this list via a converter function.

Parameters:

converter - Converter function.

Returns:

Converted list.

equals

public boolean equals(Object o)

Specified by:

equals in interface Collection<String>

Specified by:

equals in interface List<String>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<String>

Specified by:

hashCode in interface List<String>

Overrides:

hashCode in class Object

add

public void add(int index,
 String element)

Specified by:

add in interface List<String>

addAll

public boolean addAll(Collection<? extends String> c)

Specified by:

addAll in interface Collection<String>

Specified by:

addAll in interface List<String>

add

public boolean add(String e)

Specified by:

add in interface Collection<String>

Specified by:

add in interface List<String>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<String>

Specified by:

isEmpty in interface List<String>

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<String>

Specified by:

contains in interface List<String>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<String>

Specified by:

toArray in interface List<String>

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<String>

Specified by:

toArray in interface List<String>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<String>

Specified by:

remove in interface List<String>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<String>

Specified by:

containsAll in interface List<String>

addAll

public boolean addAll(int index,
 Collection<? extends String> c)

Specified by:

addAll in interface List<String>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<String>

Specified by:

removeAll in interface List<String>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<String>

Specified by:

retainAll in interface List<String>

clear

public void clear()

Specified by:

clear in interface Collection<String>

Specified by:

clear in interface List<String>

set

public String set(int index,
 String element)

Specified by:

set in interface List<String>

remove

public String remove(int index)

Specified by:

remove in interface List<String>

indexOf

public int indexOf(Object o)

Specified by:

indexOf in interface List<String>

lastIndexOf

public int lastIndexOf(Object o)

Specified by:

lastIndexOf in interface List<String>

listIterator

public ListIterator<String> listIterator()

Specified by:

listIterator in interface List<String>

listIterator

public ListIterator<String> listIterator(int index)

Specified by:

listIterator in interface List<String>

get

public String get(int index)

Specified by:

get in interface List<String>

size

public int size()

Specified by:

size in interface Collection<String>

Specified by:

size in interface List<String>

array

public String[] array()

Get a copy of the elements as an array.

Returns:

Array containing elements of this list.

indexOf

public int indexOf(String element)

Index of an element in the list.

Parameters:

element - Element.

Returns:

Index position or -1 if not found.

indexOf

public int indexOf(String element,
 int from)

Index of an element in the list.

Parameters:

element - Element.

from - Start the search from this position.

Returns:

Index position or -1 if not found.

indexOf

public int indexOf(String element,
 int from,
 int to)

Index of an element in the list.

Parameters:

element - Element.

from - Start the search from this position.

to - Stop the search before this position.

Returns:

Index position or -1 if not found.

indexOf

public int indexOf(Predicate<String> filter)

Returns the index of the first occurrence of an element in the list that satisfies the given filter.

Parameters:

filter - the predicate used to test elements in the list

Returns:

the index of the first matching element, or -1 if no element satisfies the filter

indexOf

public int indexOf(Predicate<String> filter,
 int from)

Returns the index of the first element that matches the given predicate starting from the specified index.

Parameters:

filter - the predicate used to match elements

from - the index to start the search from (inclusive)

Returns:

the index of the first matching element or -1 if no match is found

indexOf

public int indexOf(Predicate<String> filter,
 int from,
 int to)

Index of an element in the list that matches the given predicate.

Parameters:

filter - Filter predicate.

from - Start the search from this position.

to - Stop the search before this position.

Returns:

Index position or -1 if not found.

indexOf

public int indexOf(Predicate<String> filter,
 boolean unique)

Index of an element in the list that matches the given predicate.

Parameters:

filter - Filter predicate.

unique - Whether uniqueness to be checked or not.

Returns:

Index position or -1 if not found.

indexOf

public int indexOf(Predicate<String> filter,
 boolean unique,
 int from)

Index of an element in the list that matches the given predicate.

Parameters:

filter - Filter predicate.

unique - Whether uniqueness to be checked or not.

from - Start the search from this position.

Returns:

Index position or -1 if not found.

indexOf

public int indexOf(Predicate<String> filter,
 boolean unique,
 int from,
 int to)

Index of an element in the list that matches the given predicate.

Parameters:

filter - Filter predicate.

unique - Whether uniqueness to be checked or not.

from - Start the search from this position.

to - Stop the search before this position.

Returns:

Index position or -1 if not found.

contains

public boolean contains(String element)

Check whether this list contains the given element or not.

Parameters:

element - Element.

Returns:

True/false.

contains

public boolean contains(String element,
 int from)

Check whether this list contains the given element or not.

Parameters:

element - Element.

from - Start the search from this position.

Returns:

True/false.

contains

public boolean contains(String element,
 int from,
 int to)

Check whether this list contains the given element or not.

Parameters:

element - Element.

from - Start the search from this position.

to - Stop the search before this position.

Returns:

True/false.

contains

public boolean contains(Predicate<String> filter)

Check whether this list contains any element that matches a given predicate or not.

Parameters:

filter - Filter predicate.

Returns:

True/false.

contains

public boolean contains(Predicate<String> filter,
 int from)

Check whether this list contains any element that matches a given predicate or not.

Parameters:

filter - Filter predicate.

from - Start the search from this position.

Returns:

True/false.

contains

public boolean contains(Predicate<String> filter,
 int from,
 int to)

Check whether this list contains any element that matches a given predicate or not.

Parameters:

filter - Filter predicate.

from - Start the search from this position.

to - Stop the search before this position.

Returns:

True/false.

toString

public String toString()

Overrides:

toString in class Object

toString

public String toString(String delimiter)

Concatenate the elements of this list into a String with the given delimiter.

Parameters:

delimiter - Delimiter.

Returns:

Concatenated value.

stream

public Stream<String> stream()

Stream the elements.

Specified by:

stream in interface Collection<String>

Returns:

Stream.

iterator

public Iterator<String> iterator()

Specified by:

iterator in interface Collection<String>

Specified by:

iterator in interface Iterable<String>

Specified by:

iterator in interface List<String>

remove

public StringList remove(String element)

Remove an element from the list.

Parameters:

element - Element to remove.

Returns:

Modified list.

minus

public StringList minus(StringList another)

Remove elements from this list that are elements of another list.

Parameters:

another - Another list.

Returns:

Modified list.

subList

public StringList subList(int index)

Get a sub-list.

Parameters:

index - Index from which sublist to be started.

Returns:

Sub-list.

subList

public StringList subList(int start,
 int end)

Get a sub-list.

Specified by:

subList in interface List<String>

Parameters:

start - Starting index.

end - Ending index (exclusive).

Returns:

Sub-list.

concat

public StringList concat(StringList another)

Concatenate another list to this list.

Parameters:

another - Another list.

Returns:

Concatenated list.

concat

public StringList concat(String[] another)

Concatenate another list to this list.

Parameters:

another - Another list.

Returns:

Concatenated list.

concat

public StringList concat(Collection<String> collection)

Concatenate a collection to this list.

Parameters:

collection - Collection.

Returns:

Concatenated list.

concat

public static StringList concat(StringList first,
 StringList second)

Concatenate 2 lists..

Parameters:

first - First list (could be null).

second - Second list (could be null).

Returns:

Concatenated list.

concat

public static StringList concat(StringList... lists)

Concatenate an array of lists.

Parameters:

lists - Array of lists.

Returns:

Concatenated list.

concat

public static StringList concat(String[]... lists)

Concatenate an array of lists.

Parameters:

lists - Array of lists.

Returns:

Concatenated list.

copyTo

public int copyTo(String[] buffer)

Copy the elements of this list to a buffer.

Parameters:

buffer - Buffer to copy to

Returns:

Number of elements copied. Zero will be returned if buffer is null.

copyTo

public int copyTo(int startingIndex,
 String[] buffer)

Copy the elements of this list to a buffer.

Parameters:

startingIndex - Starting index of the list from where copy begins

buffer - Buffer to copy to

Returns:

Number of elements copied. Zero will be returned if buffer is null.

copyTo

public int copyTo(int startingIndex,
 int count,
 String[] buffer)

Copy the elements of this list to a buffer.

Parameters:

startingIndex - Starting index of the list from where copy begins

count - Number of elements to copy

buffer - Buffer to copy to

Returns:

Number of elements copied. Zero will be returned if buffer is null.

copyTo

public int copyTo(String[] buffer,
 int startingBufferIndex)

Copy the elements of this list to a buffer.

Parameters:

buffer - Buffer to copy to

startingBufferIndex - Starting index of the buffer from where copy begins

Returns:

Number of elements copied. Zero will be returned if buffer is null.

copyTo

public int copyTo(String[] buffer,
 int startingBufferIndex,
 int count)

Copy the elements of this list to a buffer.

Parameters:

buffer - Buffer to copy to

startingBufferIndex - Starting index of the buffer from where copy begins

count - Number of elements to copy

Returns:

Number of elements copied. Zero will be returned if buffer is null.

copyTo

public int copyTo(int startingIndex,
 String[] buffer,
 int startingBufferIndex,
 int count)

Copy the elements of this list to a buffer. Same as copyTo(int, int, String[], int).

Parameters:

startingIndex - Starting index of the list from where copy begins

buffer - Buffer to copy to

startingBufferIndex - Starting index of the buffer from where copy begins

count - Number of elements to copy

Returns:

Number of elements copied. Zero will be returned if buffer is null.

copyTo

public int copyTo(int startingIndex,
 int count,
 String[] buffer,
 int startingBufferIndex)

Copy the elements of this list to a buffer.

Parameters:

startingIndex - Starting index of the list from where copy begins

count - Number of elements to copy

buffer - Buffer to copy to

startingBufferIndex - Starting index of the buffer from where copy begins

Returns:

Number of elements copied. Zero will be returned if buffer is null.