net.rim.device.api.collection
Interface ReadableLongMap

All Superinterfaces:
Collection
All Known Implementing Classes:
LongHashtableCollection

public interface ReadableLongMap
extends Collection

Provides read access to a collection using long integer values as element keys.


Method Summary
 boolean contains(long key)
          Determines if this collection contains an element with provided long integer key.
 Object get(long key)
          Retrieves element by long integer key.
 long getKey(Object element)
          Retrieves long integer key by element.
 int size()
          Retrieves the number of elements in this collection.
 



Method Detail

size

int size()
Retrieves the number of elements in this collection.

Returns:
Number of elements in this collection.

get

Object get(long key)
Retrieves element by long integer key.

Parameters:
key - Key for desired element.
Returns:
Element associated with they key, or null if no element associated with this key.

getKey

long getKey(Object element)
Retrieves long integer key by element.

Note: This operation can be linear with respect to the number of entries in the table.

Parameters:
element - Element for which you want the key.
Returns:
Key associated with your element, or -1 if no such element exists in the collection (and thus has no key).

contains

boolean contains(long key)
Determines if this collection contains an element with provided long integer key.

Parameters:
key - Key to locate in this collection.
Returns:
True if this key exists in this collection (has an associated element); otherwise, false.





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.