Class AbstractCharCollection

java.lang.Object
com.uwyn.jhighlight.pcj.AbstractCharCollection
All Implemented Interfaces:
CharCollection
Direct Known Subclasses:
AbstractCharSet

public abstract class AbstractCharCollection extends Object implements CharCollection
This class represents an abstract base for implementing collections of char values. All operations that can be implemented using iterators are implemented as such. In most cases, this is hardly an efficient solution, and at least some of those methods should be overridden by sub-classes.

In this implementation, size() is calculated by iterating over the collection. Make sure that size() is overwritten or that iterators do not depend on the size() method.

Since:
1.0
Version:
1.3 21-08-2003 20:16
  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    Default constructor to be invoked by sub-classes.
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    add(char v)
    Throws UnsupportedOperationException.
    boolean
    Adds all the elements of a specified collection to this collection.
    void
    Clears this collection.
    boolean
    contains(char v)
    Indicates whether this collection contains a specified element.
    boolean
    Indicates whether all elements of a specified collection is contained in this collection.
    boolean
    Indicates whether this collection is empty.
    boolean
    remove(char v)
    Removes a specified element from this collection.
    boolean
    Removes all the elements of a specified collection from this collection.
    boolean
    Retains only the elements of a specified collection in this collection.
    int
    Returns the number of elements in this collection.
    char[]
    Returns the elements of this collection as an array.
    char[]
    toArray(char[] a)
    Returns the elements of this collection as an array.
    Returns a string representation of this collection.
    void
    Does nothing.

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface com.uwyn.jhighlight.pcj.CharCollection

    equals, hashCode, iterator
  • Constructor Details

    • AbstractCharCollection

      protected AbstractCharCollection()
      Default constructor to be invoked by sub-classes.
  • Method Details

    • add

      public boolean add(char v)
      Throws UnsupportedOperationException.
      Specified by:
      add in interface CharCollection
      Parameters:
      v - the element to add to this collection.
      Returns:
      true if this collection was modified as a result of adding v; returns false otherwise.
      Throws:
      UnsupportedOperationException - unconditionally.
      See Also:
    • addAll

      public boolean addAll(CharCollection c)
      Description copied from interface: CharCollection
      Adds all the elements of a specified collection to this collection.
      Specified by:
      addAll in interface CharCollection
      Parameters:
      c - the collection whose elements to add to this collection.
      Returns:
      true if this collection was modified as a result of adding the elements of c; returns false otherwise.
      See Also:
    • clear

      public void clear()
      Description copied from interface: CharCollection
      Clears this collection.
      Specified by:
      clear in interface CharCollection
    • contains

      public boolean contains(char v)
      Description copied from interface: CharCollection
      Indicates whether this collection contains a specified element.
      Specified by:
      contains in interface CharCollection
      Parameters:
      v - the element to test for containment.
      Returns:
      true if v is contained in this collection; returns false otherwise.
      See Also:
    • containsAll

      public boolean containsAll(CharCollection c)
      Description copied from interface: CharCollection
      Indicates whether all elements of a specified collection is contained in this collection.
      Specified by:
      containsAll in interface CharCollection
      Parameters:
      c - the collection whose elements to test for containment.
      Returns:
      true if all the elements of c are contained in this collection; returns false otherwise.
      See Also:
    • isEmpty

      public boolean isEmpty()
      Description copied from interface: CharCollection
      Indicates whether this collection is empty.
      Specified by:
      isEmpty in interface CharCollection
      Returns:
      true if this collection is empty; returns false otherwise.
    • remove

      public boolean remove(char v)
      Description copied from interface: CharCollection
      Removes a specified element from this collection.
      Specified by:
      remove in interface CharCollection
      Parameters:
      v - the char value to remove from this collection.
      Returns:
      true if this collection was modified as a result of removing v; returns false otherwise.
    • removeAll

      public boolean removeAll(CharCollection c)
      Description copied from interface: CharCollection
      Removes all the elements of a specified collection from this collection.
      Specified by:
      removeAll in interface CharCollection
      Parameters:
      c - the collection whose elements to remove from this collection.
      Returns:
      true if this collection was modified as a result of removing the elements of c; returns false otherwise.
    • retainAll

      public boolean retainAll(CharCollection c)
      Description copied from interface: CharCollection
      Retains only the elements of a specified collection in this collection.
      Specified by:
      retainAll in interface CharCollection
      Parameters:
      c - the collection whose elements to retain in this collection.
      Returns:
      true if this collection was modified as a result of removing the elements not contained in c; returns false otherwise.
    • size

      public int size()
      Description copied from interface: CharCollection
      Returns the number of elements in this collection.
      Specified by:
      size in interface CharCollection
      Returns:
      the number of elements in this collection.
    • toArray

      public char[] toArray()
      Description copied from interface: CharCollection
      Returns the elements of this collection as an array.
      Specified by:
      toArray in interface CharCollection
      Returns:
      a new array containing the elements of this collection.
    • toArray

      public char[] toArray(char[] a)
      Description copied from interface: CharCollection
      Returns the elements of this collection as an array.
      Specified by:
      toArray in interface CharCollection
      Parameters:
      a - an array to fill with the elements of this collection; if a is null or not big enough to contain all the elements of this collection, an new array is allocated, and a is not changed.
      Returns:
      a, if a has room for all the elements of this collection; otherwise a new array is allocated, filled with the elements of this collection, and returned.
    • trimToSize

      public void trimToSize()
      Does nothing. Sub-classes may provide an implementation to minimize memory usage, but this is not required since many implementations will always have minimal memory usage.
      Specified by:
      trimToSize in interface CharCollection
    • toString

      public String toString()
      Returns a string representation of this collection.
      Overrides:
      toString in class Object
      Returns:
      a string representation of this collection.