comtest
Class Strings

java.lang.Object
  extended by java.util.AbstractCollection<E>
      extended by java.util.AbstractList<E>
          extended by java.util.ArrayList<java.lang.String>
              extended by comtest.Strings
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<java.lang.String>, java.util.Collection<java.lang.String>, java.util.List<java.lang.String>, java.util.RandomAccess

public class Strings
extends java.util.ArrayList<java.lang.String>
implements java.lang.Cloneable

Class for handling String lists

Version:
22.9.2007
Author:
vesal
See Also:
Serialized Form
Example:
 Strings list = new Strings();
 list.size() === 0;
 list.add("$add"); list.size() === $size; list.get($index) === "$value";
 
    $add   | $size  |  $index | $value 
    -----------------------------------
     one   |   1    |   0     |  one   
     two   |   2    |   0     |  one   
     ---   |  ---   |   1     |  two   
 

Field Summary
private static long serialVersionUID
           
 
Fields inherited from class java.util.AbstractList
modCount
 
Constructor Summary
Strings()
           
 
Method Summary
 Strings add(Strings list)
          Add an other list to the end of this list
 Strings clone()
          Make a new instance from list with same strings inside
 void removeRange(int fromIndex, int toIndex)
          Remove a part from list
 Strings replace(java.lang.String target, java.lang.String replacement)
          Replace from every line target by replacement.
 java.lang.String toString(java.lang.String separator)
          Returns the list as separated by separator;
 java.lang.String toString(java.lang.String separator, java.lang.String endSeparator)
          Returns the list as separated by separator;
 
Methods inherited from class java.util.ArrayList
add, add, addAll, addAll, clear, contains, ensureCapacity, get, indexOf, isEmpty, lastIndexOf, remove, remove, set, size, toArray, toArray, trimToSize
 
Methods inherited from class java.util.AbstractList
equals, hashCode, iterator, listIterator, listIterator, subList
 
Methods inherited from class java.util.AbstractCollection
containsAll, removeAll, retainAll, toString
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.util.List
containsAll, equals, hashCode, iterator, listIterator, listIterator, removeAll, retainAll, subList
 

Field Detail

serialVersionUID

private static final long serialVersionUID
See Also:
Constant Field Values
Constructor Detail

Strings

public Strings()
Method Detail

add

public Strings add(Strings list)
Add an other list to the end of this list

Parameters:
list - what list to add
Returns:
this list reference
Example:
 Strings l1 = new Strings(), l2 = new Strings();
 l1.add("one"); l1.add("two");
 l2.add("three"); l2.add("four");
 l1.add(l2);
 l1.get(2) === "three"; l1.get(3) === "four";
 

clone

public Strings clone()
Make a new instance from list with same strings inside

Overrides:
clone in class java.util.ArrayList<java.lang.String>
Returns:
new list
Example:
 Strings l1 = new Strings(), l2;
 l1.add("one"); l1.add("two");
 l2 = l1.clone();
 l1.set(1,"three");
 l2.get(0) === "one"; l2.get(1) === "two"; l1.get(1) === "three";
 

replace

public Strings replace(java.lang.String target,
                       java.lang.String replacement)
Replace from every line target by replacement. Current list is changed, not cloned!

Parameters:
target - The sequence of char values to be replaced
replacement - The replacement sequence of char values
Returns:
reference to the same list
Example:
 Strings l1 = new Strings(); 
 l1.add("$value"); $
 
   | $value |
   ----------
   | one    |
   | two    |
   | three  |
   | four   |
 
 l1.replace("o","p"); 
 l1.get($i) === "$value";
 
    $i   |  $value
   ----------------
     0   |  pne
     1   |  twp
     2   |  three
     3   |  fpur 
 

removeRange

public void removeRange(int fromIndex,
                        int toIndex)
Remove a part from list

Overrides:
removeRange in class java.util.ArrayList<java.lang.String>
Parameters:
fromIndex - index to start
toIndex - index to stop

toString

public java.lang.String toString(java.lang.String separator,
                                 java.lang.String endSeparator)
Returns the list as separated by separator;

Parameters:
separator - what to use as separator
endSeparator - what to use as separator after last line if null or "" then no separator after last line
Returns:
list separated by separator
Example:
 Strings list = new Strings();
 list.toString("|","!") === "!";
 list.add("one");
 list.toString("|","!") === "one!";
 list.add("two");
 list.toString("|","!")  === "one|two!";
 list.toString("|","")   === "one|two";
 list.toString("|",null) === "one|two";
 

toString

public java.lang.String toString(java.lang.String separator)
Returns the list as separated by separator;

Parameters:
separator - what to use as separator
Returns:
list separated by separator
Example:
 Strings list = new Strings();
 list.toString("|") === "";
 list.add("one");
 list.toString("|") === "one";
 list.add("two");
 list.toString("|") === "one|two";