de.lmu.ifi.dbs.elki.database.ids

Interface ArrayDBIDs

All Superinterfaces:

DBIDs

All Known Subinterfaces:

ArrayModifiableDBIDs, ArrayStaticDBIDs, DBID, DBIDPair, DBIDRange, DBIDVar, IntegerArrayDBIDs, IntegerArrayStaticDBIDs

All Known Implementing Classes:

ArrayModifiableIntegerDBIDs, ArrayModifiableIntegerDBIDs.Slice, ArrayStaticIntegerDBIDs, ArrayStaticIntegerDBIDs.Slice, EmptyDBIDs, IntegerDBID, IntegerDBIDPair, IntegerDBIDPair.Slice, IntegerDBIDRange, IntegerDBIDVar, UnmodifiableIntegerArrayDBIDs

public interface ArrayDBIDs
extends DBIDs

Interface for array based DBIDs.

Since:

0.4.0

Author:

Erich Schubert

Method Summary

Modifier and Type	Method and Description
DBIDVar	assignVar(int index, DBIDVar var) Assign a DBID variable the value of position index.
int	binarySearch(DBIDRef key) Search for the position of the given key, assuming that the data set is sorted.
DBID	get(int i) Deprecated. Preferably use a DBIDArrayIter or a DBIDVar instead of materializing expensive DBID objects.
DBIDArrayIter	iter() Iterable
int	size() Size of the DBID "collection".
ArrayDBIDs	slice(int begin, int end) Slice a subarray (as view, not copy!)

Methods inherited from interface de.lmu.ifi.dbs.elki.database.ids.DBIDs

contains, forEach, isEmpty

Method Detail

get

@Deprecated
DBID get(int i)

Deprecated. Preferably use a DBIDArrayIter or a DBIDVar instead of materializing expensive DBID objects.

Get the i'th entry (starting at 0)

If possible, use an DBIDArrayIter via iter() instead, or an DBIDVar via assignVar(int, de.lmu.ifi.dbs.elki.database.ids.DBIDVar)

Parameters:

i - Index

Returns:

DBID of i'th entry.

assignVar

DBIDVar assignVar(int index,
                  DBIDVar var)

Assign a DBID variable the value of position index.

Parameters:

index - Position

var - Variable to assign the value to.

iter

DBIDArrayIter iter()

Iterable

Specified by:

iter in interface DBIDs

Returns:

Iterator

size

int size()

Size of the DBID "collection".

Specified by:

size in interface DBIDs

Returns:

size

binarySearch

int binarySearch(DBIDRef key)

Search for the position of the given key, assuming that the data set is sorted. For unsorted arrays, the result is undefined.

For keys not found, -(1+insertion position) is returned, as for Java Collections.binarySearch(java.util.List<? extends java.lang.Comparable<? super T>>, T)

Parameters:

key - Key to search for

Returns:

Offset of key

slice

ArrayDBIDs slice(int begin,
                 int end)

Slice a subarray (as view, not copy!)

Parameters:

begin - Begin (inclusive)

end - End (exclusive)

Returns:

Array slice.