ArrayListOfShorts (lintools-datatypes 1.1.1 API)

java.lang.Object
- tl.lin.data.array.ArrayListOfShorts

All Implemented Interfaces:

Cloneable, Iterable<Short>, RandomAccess

Direct Known Subclasses:

ArrayListOfShortsWritable
```
public class ArrayListOfShorts
extends Object
implements RandomAccess, Cloneable, Iterable<Short>
```
Object representing a list of shorts, backed by an resizable-array.

Field Summary

Fields
Modifier and Type Field and Description

protected short[] array

protected int size

Fields
Modifier and Type	Field and Description
`protected short[]`	`array`
`protected int`	`size`

Constructor Summary

Constructors
Constructor and Description
`ArrayListOfShorts()` Constructs an empty list with an initial capacity of ten.
`ArrayListOfShorts(int initialCapacity)` Constructs an empty list with the specified initial capacity.
`ArrayListOfShorts(short[] a)` Constructs a list from an array.
`ArrayListOfShorts(short first, short last)` Constructs a list populated with shorts in range [first, last).

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`ArrayListOfShorts`	`add(int index, short element)` Inserts the specified element at the specified position in this list.
`ArrayListOfShorts`	`add(short e)` Appends the specified element to the end of this list.
`void`	`addUnique(short[] arr)` Add all shorts in the specified array into this list, ignoring duplicates.
`void`	`clear()` Removes all of the elements from this list.
`ArrayListOfShorts`	`clone()` Returns a clone of this object.
`boolean`	`contains(short n)` Returns `true` if this list contains the specified element.
`void`	`ensureCapacity(int minCapacity)` Increases the capacity of this object, if necessary, to ensure that it can hold at least the number of elements specified by the minimum capacity argument.
`boolean`	`equals(Object obj)` Elementwise comparison.
`short`	`get(int index)` Returns the element at the specified position in this list.
`short[]`	`getArray()` Returns the array backing this object.
`int`	`indexOf(short n)` Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.
`ArrayListOfShorts`	`intersection(ArrayListOfShorts other)` Computes the intersection of two sorted lists of unique shorts.
`boolean`	`isEmpty()` Returns `true` if this list contains no elements.
`Iterator<Short>`	`iterator()` Returns an iterator for this list.
`int`	`lastIndexOf(short n)` Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.
`ArrayListOfShorts`	`merge(ArrayListOfShorts sortedLst)` Merges two sorted (ascending order) lists into one sorted union.
`short`	`remove(int index)` Removes the element at the specified position in this list.
`short`	`set(int index, short element)` Replaces the element at the specified position in this list with the specified element.
`void`	`setSize(int sz)` Specifies the length of this list.
`void`	`shiftLastNToTop(int n)`
`int`	`size()` Returns the number of elements in this list.
`void`	`sort()` Sorts this list.
`ArrayListOfShorts`	`subList(int start, int end)` Extracts a sub-list.
`String`	`toString()`
`String`	`toString(int n)` Returns a string representation of the object, explicitly printing out the first n elements of this list.
`void`	`trimToSize()` Trims the capacity of this object to be the list's current size.

Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Field Detail
  - array
```
protected transient short[] array
```
  - size
```
protected int size
```
- Constructor Detail
  - ArrayListOfShorts
```
public ArrayListOfShorts(int initialCapacity)
```
    Constructs an empty list with the specified initial capacity.
    
    Parameters:
    
    initialCapacity - the initial capacity of the list
    
    Throws:
    
    IllegalArgumentException - if the specified initial capacity is negative
  - ArrayListOfShorts
```
public ArrayListOfShorts()
```
    Constructs an empty list with an initial capacity of ten.
  - ArrayListOfShorts
```
public ArrayListOfShorts(short[] a)
```
    Constructs a list from an array. Defensively makes a copy of the array.
    
    Parameters:
    
    a - source array
  - ArrayListOfShorts
```
public ArrayListOfShorts(short first,
                         short last)
```
    Constructs a list populated with shorts in range [first, last).
    
    Parameters:
    
    first - the smallest short in the range (inclusive)
    
    last - the largest short in the range (exclusive)
- Method Detail
  - trimToSize
```
public void trimToSize()
```
    Trims the capacity of this object to be the list's current size. An application can use this operation to minimize the memory footprint of this object.
  - ensureCapacity
```
public void ensureCapacity(int minCapacity)
```
    Increases the capacity of this object, if necessary, to ensure that it can hold at least the number of elements specified by the minimum capacity argument.
    
    Parameters:
    
    minCapacity - the desired minimum capacity
  - size
```
public int size()
```
    Returns the number of elements in this list.
  - setSize
```
public void setSize(int sz)
```
    Specifies the length of this list.
  - isEmpty
```
public boolean isEmpty()
```
    Returns true if this list contains no elements.
  - contains
```
public boolean contains(short n)
```
    Returns true if this list contains the specified element.
    
    Parameters:
    
    n - element whose presence in this list is to be tested
    
    Returns:
    
    true if this list contains the specified element
  - indexOf
```
public int indexOf(short n)
```
    Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.
  - lastIndexOf
```
public int lastIndexOf(short n)
```
    Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.
  - clone
```
public ArrayListOfShorts clone()
```
    Returns a clone of this object.
    
    Overrides:
    
    clone in class Object
  - get
```
public short get(int index)
```
    Returns the element at the specified position in this list.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    the element at the specified position in this list
  - set
```
public short set(int index,
                 short element)
```
    Replaces the element at the specified position in this list with the specified element.
    
    Parameters:
    
    index - index of the element to replace
    
    element - element to be stored at the specified position
    
    Returns:
    
    the element previously at the specified position
  - add
```
public ArrayListOfShorts add(short e)
```
    Appends the specified element to the end of this list.
  - add
```
public ArrayListOfShorts add(int index,
                             short element)
```
    Inserts the specified element at the specified position in this list. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).
    
    Parameters:
    
    index - index at which the specified element is to be inserted
    
    element - element to be inserted
  - remove
```
public short remove(int index)
```
    Removes the element at the specified position in this list. Shifts any subsequent elements to the left (subtracts one from their indices).
    
    Parameters:
    
    index - the index of the element to be removed
    
    Returns:
    
    the element that was removed from the list
  - clear
```
public void clear()
```
    Removes all of the elements from this list. The list will be empty after this call returns.
  - getArray
```
public short[] getArray()
```
    Returns the array backing this object. Note that this array may be longer than the number of elements in the list.
    
    Returns:
    
    array backing this object
  - iterator
```
public Iterator<Short> iterator()
```
    Returns an iterator for this list. Note that this method is included only for convenience to conform to the Iterable interface; this method is not efficient because of autoboxing.
    
    Specified by:
    
    iterator in interface Iterable<Short>
  - toString
```
public String toString(int n)
```
    Returns a string representation of the object, explicitly printing out the first n elements of this list.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - sort
```
public void sort()
```
    Sorts this list.
  - intersection
```
public ArrayListOfShorts intersection(ArrayListOfShorts other)
```
    Computes the intersection of two sorted lists of unique shorts.
    
    Parameters:
    
    other - other list to be intersected with this list
    
    Returns:
    
    intersection of the two lists
  - merge
```
public ArrayListOfShorts merge(ArrayListOfShorts sortedLst)
```
    Merges two sorted (ascending order) lists into one sorted union.
    
    Parameters:
    
    sortedLst - list to be merged into this
    
    Returns:
    
    merged sorted (ascending order) union of this and sortedLst
  - subList
```
public ArrayListOfShorts subList(int start,
                                 int end)
```
    Extracts a sub-list.
    
    Parameters:
    
    start - first index to be included in sub-list
    
    end - last index to be included in sub-list
    
    Returns:
    
    a new ArrayListOfInts from start to end
  - addUnique
```
public void addUnique(short[] arr)
```
    Add all shorts in the specified array into this list, ignoring duplicates.
    
    Parameters:
    
    arr - array of shorts to add to this object
  - shiftLastNToTop
```
public void shiftLastNToTop(int n)
```
  - equals
```
public boolean equals(Object obj)
```
    Elementwise comparison. Shorter always comes before if it is a sublist of longer. No preference if both are empty.
    
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    obj - other object this is compared against

Class ArrayListOfShorts

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Field Detail

array

size

Constructor Detail

ArrayListOfShorts

ArrayListOfShorts

ArrayListOfShorts

ArrayListOfShorts

Method Detail

trimToSize

ensureCapacity

size

setSize

isEmpty

contains

indexOf

lastIndexOf

clone

get

set

add

add

remove

clear

getArray

iterator

toString

toString

sort

intersection

merge

subList

addUnique

shiftLastNToTop

equals