ArrayList

classin packageklyn.collections

public class ArrayList<T> extends Object implements List<T>

Object

└ ArrayList

All Implemented Interfaces: List

Resizable array list.

Bulk insertion captures its source before changing the list, so inserting the list into itself is supported. Primitive-specialized targets consume primitive sources without intermediate boxing. Inserting m items shifts the target suffix once: the cost is O(m + suffix length), with O(m) source snapshot storage.

Native operator mapping:

operator[] is mapped to the native klyn_collections_ArrayList_operator_index.

Example

import klyn.collections

values = [1, 2]
values.addAll(1, values)
assert values == [1, 1, 2, 2]

Properties

Modifier and Type	Member	Description
public override readonly native property	size `size as ULong`	Number of elements in the list.

Inherited Properties

propertyInherited Properties from Object: type

propertyInherited Properties from Collection: size

Constructors

Modifier and Type	Member	Description
public	ArrayList `ArrayList()`	Creates an empty ArrayList.
public	ArrayList `ArrayList(collection as Collection<T>)`	Creates an ArrayList from a collection.
public	ArrayList `ArrayList(list as IList<T>)`	Creates an ArrayList from a read-only list.
public	ArrayList `ArrayList(source as Set<T>)`	Creates an ArrayList from a set.
public	ArrayList `ArrayList(tuple as Tuple)`	Creates an ArrayList from a tuple.

Methods

Modifier and Type	Member	Description
public native	add `add(index as Long, item as T) as Void`	Inserts an element at the requested index.
public native	add `add(item as T) as Void`	Adds an element at the end.
public native	addAll `addAll(index as Long, values as IList<T>) as Void`	Inserts every element from a read-only list at the requested index.
public native	addAll `addAll(index as Long, values as Set<T>) as Void`	Inserts every element from a set at the requested index.
public native	addAll `addAll(index as Long, values as Tuple) as Void`	Inserts every element from a tuple at the requested index.
public native	addAll `addAll(values as IList<T>) as Void`	Appends every element from a read-only list.
public native	addAll `addAll(values as Set<T>) as Void`	Appends every element from a set.
public native	addAll `addAll(values as Tuple) as Void`	Appends every element from a tuple.
public native	clear `clear() as Void`	Removes all elements.
public native	count `count(item as T) as ULong`	Counts occurrences of the given element in the list.
public native	indexOf `indexOf(item as T, start as Long = 0) as Long`	Returns the first index of the given element.
public native	join `join(separator as String) as String`	Joins elements into a single string using the separator.
public native	lastIndexOf `lastIndexOf(item as T, start as Long = -1) as Long`	Returns the last index of the given element.
public native	remove `remove(item as T) as Boolean`	Removes the first matching element.
public native	removeAt `removeAt(index as Long) as Void`	Removes the element at the requested index.
public native	reserve `reserve(capacity as Long) as Void`	Reserves internal storage for at least the requested number of elements.
public native	reverse `reverse() as Void`	Reverses list elements in-place.
public native	reverseNew `reverseNew() as ArrayList<T>`	Returns a new reversed list without modifying the original.
public native	shuffle `shuffle() as Void`	Randomly shuffles the list in-place.
public native	sort `sort() as Void`	Sorts the list in ascending order.
public native	sortNew `sortNew() as ArrayList<T>`	Returns a new sorted ArrayList without modifying the original.
public override native	toString `toString() as String`	Returns a string representation of the list.

Inherited Methods

methodInherited Methods from Object: deepCopy, fromJson, hash, toDict, toJson, toMap, toString, toXml

methodInherited Methods from List: add, add, addAll, addAll, addAll, addAll, addAll, addAll, remove, removeAt, reverse, reverseNew, shuffle, sort, sortNew

methodInherited Methods from Collection: clear, count

Operators

Modifier and Type	Member	Description
public native	operator in(item as T) as Boolean	Returns true if the list contains the given element.
public native static	operator+(readonly notnull left as ArrayList<T>, readonly notnull right as ArrayList<T>) as ArrayList<T>	Concatenates two ArrayList instances into a new ArrayList.
public native	operator+=(values as IList<T>) as Void	Appends every element from a read-only list.
public native	operator+=(values as Set<T>) as Void	Appends every element from a set.
public native	operator+=(values as Tuple) as Void	Appends every element from a tuple.
public native	operator[](index as Long) as T	Gets the element at the given index.

Inherited Operators

operatorInherited Operators from List: operator+(notnull left as List<T>, notnull right as List<T>) as List<T>, operator+=(values as IList<T>) as Void, operator+=(values as Set<T>) as Void, operator+=(values as Tuple) as Void

operatorInherited Operators from Collection: operator in(item as T) as Boolean