IList

Kind of class: public interface
Package:
Inherits from:
  • none
Implemented by:
Version: 06/04/09
Author: Aaron Clinger, Dave Nelson
Classpath: org.casalib.collection.IList
File last modified: Friday, 20 May 2011, 00:59:44
► View source▼ Hide source
/*
    CASA Lib for ActionScript 3.0
    Copyright (c) 2011, Aaron Clinger & Contributors of CASA Lib
    All rights reserved.
    
    Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions are met:
    
    - Redistributions of source code must retain the above copyright notice,
      this list of conditions and the following disclaimer.
    
    - Redistributions in binary form must reproduce the above copyright notice,
      this list of conditions and the following disclaimer in the documentation
      and/or other materials provided with the distribution.
    
    - Neither the name of the CASA Lib nor the names of its contributors
      may be used to endorse or promote products derived from this software
      without specific prior written permission.
    
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
    ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
    LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
    CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
    SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
    INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
    CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
    ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
    POSSIBILITY OF SUCH DAMAGE.
*/
package org.casalib.collection {
    
    /**
        Interface for list collections.
        
        @author Aaron Clinger
        @author Dave Nelson
        @version 06/04/09
    */
    public interface IList {
        
        
        /**
            Appends the specified item to the end of this list.
            
            @param item: Element to be inserted.
            @return Returns true if the list was changed as a result of the call; otherwise false.
        */
        function addItem(item:*):Boolean;
        
        /**
            Inserts an item as a specified position.
            
            @param item: Element to be inserted.
            @param index: Position where the elements should be added.
            @return Returns true if the list was changed as a result of the call; otherwise false.
        */
        function addItemAt(item:*, index:int):Boolean;
        
        /**
            Modifies original list by adding all the elements from another list.
            
            @param items: List of elements to add.
            @return Returns true if the list was changed as a result of the call; otherwise false.
        */
        function addItems(items:IList):Boolean;
        
        /**
            Modifies original list by adding all the elements from another list at a specified position.
            
            @param items: List of elements to add.
            @param index: Position where the elements should be added.
            @return Returns true if the list was changed as a result of the call; otherwise false.
        */
        function addItemsAt(items:IList, index:int = 0x7fffffff):Boolean;
        
        /**
            Removes all of the items from this list.
        */
        function clear():void;
        
        /**
            Determines if this list contains a specified element.
            
            @param item: Element to search for.
            @return Returns true if the list contains the element; otherwise false.
        */
        function contains(item:*):Boolean;
        
        /**
            Determines if this list contains all of the elements of the specified list.
            
            @param items: List of elements to be checked for containment.
            @return Returns true if list contains all elements of the list; otherwise false.
        */
        function containsAll(items:IList):Boolean;
        
        /**
            Determines if the list specified in the list parameter is equal to this list object.
            
            @param list: An object that implements {@link IList}.
            @return Returns true if the object is equal to this list; otherwise false.
        */
        function equals(list:IList):Boolean;
        
        /**
            Returns the element at the specified position in this list.
            
            @param index: The position of the element to return.
            @return The element at the specified position in this list.
        */
        function getItemAt(index:uint):*;
        
        /**
            Returns a portion of this list.
            
            @param startIndex: The starting position.
            @param endIndex: The ending position.
            @return The specified portion of the list.
        */
        function subList(startIndex:int = 0, endIndex:int = 16777215):IList;
        
        /**
            Finds the position of the first occurrence of a specified item.
            
            @param item: The element to search for.
            @param fromIndex: The position in the list from which to start searching for the item.
            @return Returns the index of the last occurrence, or -1 if the element doesn't exist.
        */
        function indexOf(item:*, fromIndex:int = 0):int;
        
        /**
            Determines if this list contains no elements.
            
            @return Returns true if the list contains no items; otherwise false.
        */
        function isEmpty():Boolean;
        
        /**
            Finds the position of the last occurrence of a specified item.
            
            @param item: The element to search for.
            @param fromIndex: The position in the list from which to start searching for the item.
            @return Returns the index of the last occurrence, or -1 if the element doesn't exist.
        */
        function lastIndexOf(item:*, fromIndex:int = 0x7fffffff):int;
        
        /**
            The number of elements in the list.
        */
        function get size():uint;
        
        /**
            Modifies the list by removing all items that are identical to the specified item.
            
            @param item: Element to remove.
            @return Returns true if the list was changed as a result of the call; otherwise false.
        */
        function removeAllInstancesOfItem(item:*):Boolean;
        
        /**
            Removes the first occurance of the specified item in the list.
            
            @param item: Element to remove.
            @return Returns true if the list contained the item; otherwise false.
        */
        function removeItem(item:*):Boolean;
        
        /**
            Removes the element at the specified position in this list.
            
            @param index: The position of the item to removed.
            @return The item previously at the specified index.
        */
        function removeItemAt(index:int):*;
        
        /**
            Removes only the specified items in a list.
            
            @param items: List of elements to remove.
            @return Returns true if the list was changed as a result of the call; otherwise false.
        */
        function removeItems(items:IList):Boolean;
        
        /**
            Retains only the specified items in a list.
            
            @param items: List of elements to keep.
            @return Returns true if the list was changed as a result of the call; otherwise false.
        */
        function retainItems(items:IList):Boolean;
        
        /**
            Replaces an item at a specified position.
            
            @param item: The item to be stored.
            @param index: The index of the item to replace.
            @return The element previously at the specified position.
        */
        function setItem(item:*, index:int):*;
        
        /**
            Returns an Array containing all of the elements in the list in order.
            
            @return Returns an Array containing all of the elements in the list in order.
        */
        function toArray():Array;
        
        /**
            Returns a list that is an exact copy of the original list.
            
            @return Returns a list that is an exact copy of the original list.
        */
        function clone():IList;
        
        /**
            Returns a string that represents the items in the list.
            
            @return Returns a string that represents the items in the list.
        */
        function toString():String
    }
}
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, endIndex:int = 16777215) : IList
    • Returns a portion of this list.
  • indexOf (item = *, fromIndex:int) : 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.

Instance properties

size

size:uint(read)

The number of elements in the list.

Instance methods

addItem

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

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

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

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

function clear() : void

Removes all of the items from this list.

clone

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

function contains(item = *) : Boolean

Determines if this list contains a specified element.

Parameters
item:Element to search for.
Returns
  • Returns true if the list contains the element; otherwise false.

containsAll

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

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

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

function indexOf(item = *, fromIndex:int) : 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

function isEmpty() : Boolean

Determines if this list contains no elements.

Returns
  • Returns true if the list contains no items; otherwise false.

lastIndexOf

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

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

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

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

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

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

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

function subList(startIndex:int, 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

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.