ArrayList

Object Hierarchy:

Description:

    var list = new ArrayList<string> (GLib.str_equal);
    list.add ("hello");
    list.add ("world");
    assert (list.size () == 2);
    assert (list.get (0) == "hello");
    assert (list.contains ("hello"));

    var filtered = list.filter ((s) => { return s == "hello"; });
    assert (filtered.size () == 1);

Content:

Creation methods:

• public ArrayList (EqualFunc<T>? equal_func = null)
  Creates an empty ArrayList.

Methods:

• public T @get (int index)
  Returns the element at the specified index. Returns null if the index is out of bounds.
• public bool @set (int index, owned T element)
  Replaces the element at the specified index. Returns false if the index is out of bounds.
• public void add (owned T element)
  Adds an element to the end of the list.
• public void addAll (ArrayList<T> other)
  Adds all elements from another ArrayList to the end of this list.
• public void clear ()
  Removes all elements from the list.
• public bool contains (T element)
  Returns whether the list contains the specified element. Uses the equality function provided in the constructor, or pointer equality if none was provided.
• public ArrayList<T> filter (owned PredicateFunc<T> func)
  Returns a new ArrayList containing only the elements that match the given predicate.
• public Optional<T> find (owned PredicateFunc<T> func)
  Returns an Optional containing the first element that matches the given predicate. Returns an empty Optional if no element matches.
• public void forEach (owned ConsumerFunc<T> func)
  Applies the given function to each element in the list.
• public int indexOf (T element)
  Returns the index of the first occurrence of the specified element. Returns -1 if the element is not found. Uses the equality function provided in the constructor, or pointer equality if none was provided.
• public bool isEmpty ()
  Returns whether the list is empty.
• public ArrayList<U> map<U> (owned MapFunc<T,U> func)
  Returns a new ArrayList containing the results of applying the given function to each element.
• public U reduce<U> (U initial, owned ReduceFunc<T,U> func)
  Reduces the list to a single value by applying the given function to each element, accumulating the result from the initial value.
• public T removeAt (int index)
  Removes and returns the element at the specified index. Returns null if the index is out of bounds.
• public uint size ()
  Returns the number of elements in the list.
• public void sort (owned ComparatorFunc<T> func)
  Sorts the list in-place using the provided comparison function.
• public ArrayList<T> subList (int from, int to)
  Returns a new ArrayList containing elements from index from (inclusive) to index to (exclusive). If the indices are out of bounds, they are clamped to valid range. If from >= to , returns an empty list.
• public T[] toArray ()
  Returns the elements as a native array.

Inherited Members: