Package org.cip4.jdflib.core

Class StringArray

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<String>

org.cip4.jdflib.core.StringArray

All Implemented Interfaces:

Serializable, Cloneable, Iterable<String>, Collection<String>, List<String>, RandomAccess

public class StringArray
extends ArrayList<String>

See Also:

• Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor	Description
StringArray()	constructor
StringArray(String strIn)	convenience - constructs a VString by tokenizing a string
StringArray(String[] a)	creates a VString from an array of Strings
StringArray(String strIn, String strSep)	constructs a VString by tokenizing a string
StringArray(Collection<String> m)	constructor

Method Summary

Modifier and Type	Method	Description
void	add(int index, String element)
boolean	add(String e)
void	addAll(String[] strings)	appends all strings of an array to this
void	addNonEmpty(String text)	add a string if it is not empty
void	appendUnique(String string)	AppendUnique - append a string but ignore multiple entries
void	appendUnique(Collection<String> v)	AppendUnique - append a vector but ignore multiple entries
boolean	containsAny(Collection<String> others)	checks whether at least one of a given vector of strings is contained in this
String	get(int index)
StringArray	getOverlapping(Collection<String> others)	vector of strings that is contained in this
Set<String>	getSet()	gets a set with all entries of the VString note that the set retains ordering (LinkedHashSet)
String	getString()	serialize to a string
String	getString(String sep, String front, String back)	serialize to a string
static StringArray	getVString(String strIn, String strSep)	simple static factory - null if strIn is null or empty
static boolean	isEmpty(Collection<String> v)	are we null or empty or contain only an empty JDFAttributeMap
String	remove(int index)	remove but also implementing the usual neg number syntax
String	set(int index, String element)
void	unify()	unify - make VString unique, retaining initial order

Methods inherited from class java.util.ArrayList

addAll, addAll, clear, clone, contains, ensureCapacity, equals, forEach, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, removeAll, removeIf, removeRange, replaceAll, retainAll, size, sort, spliterator, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractCollection

containsAll, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, stream, toArray

Methods inherited from interface java.util.List

containsAll

Constructor Details

StringArray

public StringArray()

constructor

StringArray

public StringArray(Collection<String> m)

constructor

Parameters:

m -

StringArray

public StringArray(String strIn)

convenience - constructs a VString by tokenizing a string

Parameters:

strIn - the string to tokenize by blank

StringArray

public StringArray(String strIn,
 String strSep)

constructs a VString by tokenizing a string

Parameters:

strIn - the string to tokenize

strSep - the list of separator characters - null if whitespace

StringArray

public StringArray(String[] a)

creates a VString from an array of Strings

Parameters:

a - the array

Method Details

set

public String set(int index,
 String element)

Specified by:

set in interface List<String>

Overrides:

set in class ArrayList<String>

add

public boolean add(String e)

Specified by:

add in interface Collection<String>

Specified by:

add in interface List<String>

Overrides:

add in class ArrayList<String>

add

public void add(int index,
 String element)

Specified by:

add in interface List<String>

Overrides:

add in class ArrayList<String>

isEmpty

public static boolean isEmpty(Collection<String> v)

are we null or empty or contain only an empty JDFAttributeMap

Parameters:

v -

Returns:

getVString

public static StringArray getVString(String strIn,
 String strSep)

simple static factory - null if strIn is null or empty

Parameters:

strIn -

strSep -

Returns:

get

public String get(int index)

Specified by:

get in interface List<String>

Overrides:

get in class ArrayList<String>

Parameters:

index - the index which may be negative to count backwards

Returns:

the string at index

appendUnique

public void appendUnique(String string)

AppendUnique - append a string but ignore multiple entries

Parameters:

string - the string to append, if null nothing is added

appendUnique

public void appendUnique(Collection<String> v)

AppendUnique - append a vector but ignore multiple entries

Parameters:

v - the vector to append, if null nothing is added

getString

public String getString(String sep,
 String front,
 String back)

serialize to a string

Parameters:

sep - separator between strings

front - string before the first entry

back - string after the last entry

Returns:

a tokenized string

getString

public String getString()

serialize to a string

Parameters:

sep - separator between strings

front - string before the first entry

back - string after the last entry

Returns:

a tokenized string

unify

public void unify()

unify - make VString unique, retaining initial order

getSet

public Set<String> getSet()

gets a set with all entries of the VString
note that the set retains ordering (LinkedHashSet)

Returns:

the set corresponding to this

addAll

public void addAll(String[] strings)

appends all strings of an array to this

Parameters:

strings - the array of strings to append to this

containsAny

public boolean containsAny(Collection<String> others)

checks whether at least one of a given vector of strings is contained in this

Parameters:

others - the VSTring of values to test

Returns:

true if at least one String in other is in this

getOverlapping

public StringArray getOverlapping(Collection<String> others)

vector of strings that is contained in this

Parameters:

others - the VString of values to test

Returns:

true if at least one String in other is in this

remove

public String remove(int index)

remove but also implementing the usual neg number syntax

Specified by:

remove in interface List<String>

Overrides:

remove in class ArrayList<String>

Parameters:

index - if 0, or positive count from front, else if negative from back

See Also:

• Vector.remove(int)

addNonEmpty

public void addNonEmpty(String text)

add a string if it is not empty

Parameters:

text -