IList

Kind of class:public interface
Package:org.casalib.collection
Inherits from:none
Implemented by:
Version:09/29/08
Author:Aaron Clinger, Dave Nelson
Classpath:org.casalib.collection.IList
File last modified:Wednesday, 31 December 2008, 20:18:28
Interface for list collections.

Summary


Instance properties
  • size : uint
    • The number of elements in the list.
Instance methods
  • addItem (item:*) : Boolean
    • Appends the specified item to the end of this list.
  • addItemAt (item:*, index:int) : Boolean
    • Inserts an item as a specified position.
  • addItems (items:IList) : Boolean
    • Modifies original list by adding all the elements from another list.
  • addItemsAt (items:IList, index:int = 0x7fffffff) : Boolean
    • Modifies original list by adding all the elements from another list at a specified position.
  • clear : void
    • Removes all of the items from this list.
  • contains (item:*) : Boolean
    • Determines if this list contains a specified element.
  • containsAll (items:IList) : Boolean
    • Determines if this list contains all of the elements of the specified list.
  • equals (list:IList) : Boolean
    • Determines if the list specified in the list parameter is equal to this list object.
  • getItemAt (index:uint) : *
    • Returns the element at the specified position in this list.
  • subList (startIndex:int = 0, endIndex:int = 16777215) : IList
    • Returns a portion of this list.
  • indexOf (item:*, fromIndex:int = 0) : int
    • Finds the position of the first occurrence of a specified item.
  • isEmpty : Boolean
    • Determines if this list contains no elements.
  • lastIndexOf (item:*, fromIndex:int = 0x7fffffff) : int
    • Finds the position of the last occurrence of a specified item.
  • removeAllInstancesOfItem (item:*) : Boolean
    • Modifies the list by removing all items that are identical to the specified item.
  • removeItem (item:*) : Boolean
    • Removes the first occurance of the specified item in the list.
  • removeItemAt (index:int) : *
    • Removes the element at the specified position in this list.
  • removeItems (items:IList) : Boolean
    • Removes only the specified items in a list.
  • retainItems (items:IList) : Boolean
    • Retains only the specified items in a list.
  • setItem (item:*, index:int) : *
    • Replaces an item at a specified position.
  • toArray : Array
    • Returns an Array containing all of the elements in the list in order.
  • clone : IList
    • Returns a list that is an exact copy of the original list.
  • toString : String
    • Returns a string that represents the items in the list.

Instance properties

size

public size:uint
(read)

The number of elements in the list.

Instance methods

addItem

public function addItem (
item:*) : Boolean

Appends the specified item to the end of this list.
Parameters:
item:
Element to be inserted.
Returns:
  • Returns true if the list was changed as a result of the call; otherwise false.

addItemAt

public function addItemAt (
item:*, index:int) : Boolean

Inserts an item as a specified position.
Parameters:
item :
Element to be inserted.
index:
Position where the elements should be added.
Returns:
  • Returns true if the list was changed as a result of the call; otherwise false.

addItems

public function addItems (
items:IList) : Boolean

Modifies original list by adding all the elements from another list.
Parameters:
items:
List of elements to add.
Returns:
  • Returns true if the list was changed as a result of the call; otherwise false.

addItemsAt

public function addItemsAt (
items:IList, index:int = 0x7fffffff) : Boolean

Modifies original list by adding all the elements from another list at a specified position.
Parameters:
items:
List of elements to add.
index:
Position where the elements should be added.
Returns:
  • Returns true if the list was changed as a result of the call; otherwise false.

clear

public function clear (
) : void

Removes all of the items from this list.

clone

public function clone (
) : IList

Returns a list that is an exact copy of the original list.
Returns:
  • Returns a list that is an exact copy of the original list.

contains

public function contains (
item:*) : Boolean

Determines if this list contains a specified element.
Parameters:
item:
Element to search for.
Returns:
  • The amount of items found; if none were found returns 0.

containsAll

public function containsAll (
items:IList) : Boolean

Determines if this list contains all of the elements of the specified list.
Parameters:
items:
List of elements to be checked for containment.
Returns:
  • Returns true if list contains all elements of the list; otherwise false.

equals

public function equals (
list:IList) : Boolean

Determines if the list specified in the list parameter is equal to this list object.
Parameters:
list:
An object that implements IList.
Returns:
  • Returns true if the object is equal to this list; otherwise false.

getItemAt

public function getItemAt (
index:uint) : *

Returns the element at the specified position in this list.
Parameters:
index:
The position of the element to return.
Returns:
  • The element at the specified position in this list.

indexOf

public function indexOf (
item:*, fromIndex:int = 0) : int

Finds the position of the first occurrence of a specified item.
Parameters:
item :
The element to search for.
fromIndex:
The position in the list from which to start searching for the item.
Returns:
  • Returns the index of the last occurrence, or -1 if the element doesn't exist.

isEmpty

public function isEmpty (
) : Boolean

Determines if this list contains no elements.
Returns:
  • Returns true if the list contains no items; otherwise false.

lastIndexOf

public function lastIndexOf (
item:*, fromIndex:int = 0x7fffffff) : int

Finds the position of the last occurrence of a specified item.
Parameters:
item :
The element to search for.
fromIndex:
The position in the list from which to start searching for the item.
Returns:
  • Returns the index of the last occurrence, or -1 if the element doesn't exist.

removeAllInstancesOfItem

public function removeAllInstancesOfItem (
item:*) : Boolean

Modifies the list by removing all items that are identical to the specified item.
Parameters:
item:
Element to remove.
Returns:
  • Returns true if the list was changed as a result of the call; otherwise false.

removeItem

public function removeItem (
item:*) : Boolean

Removes the first occurance of the specified item in the list.
Parameters:
item:
Element to remove.
Returns:
  • Returns true if the list contained the item; otherwise false.

removeItemAt

public function removeItemAt (
index:int) : *

Removes the element at the specified position in this list.
Parameters:
index:
The position of the item to removed.
Returns:
  • The item previously at the specified index.

removeItems

public function removeItems (
items:IList) : Boolean

Removes only the specified items in a list.
Parameters:
items:
List of elements to remove.
Returns:
  • Returns true if the list was changed as a result of the call; otherwise false.

retainItems

public function retainItems (
items:IList) : Boolean

Retains only the specified items in a list.
Parameters:
items:
List of elements to keep.
Returns:
  • Returns true if the list was changed as a result of the call; otherwise false.

setItem

public function setItem (
item:*, index:int) : *

Replaces an item at a specified position.
Parameters:
item :
The item to be stored.
index:
The index of the item to replace.
Returns:
  • The element previously at the specified position.

subList

public function subList (
startIndex:int = 0, endIndex:int = 16777215) : IList

Returns a portion of this list.
Parameters:
startIndex:
The starting position.
endIndex :
The ending position.
Returns:
  • The specified portion of the list.

toArray

public function toArray (
) : Array

Returns an Array containing all of the elements in the list in order.
Returns:
  • Returns an Array containing all of the elements in the list in order.

toString

public function toString (
) : String

Returns a string that represents the items in the list.
Returns:
  • Returns a string that represents the items in the list.