com.bigdata.rdf.graph.impl.util

Interface IArraySlice<T>

All Superinterfaces:

Iterable<T>

All Known Subinterfaces:

IManagedArray<T>

All Known Implementing Classes:

ManagedArray

public interface IArraySlice<T>
extends Iterable<T>

Interface for a slice of a backing array.

Version:

$Id: IByteArraySlice.java 4548 2011-05-25 19:36:34Z thompsonbry $

Author:

Bryan Thompson

Method Summary

Methods

Modifier and Type	Method and Description
T[]	array() The backing array.
T	get(int pos) Absolute get of a value at an index.
void	get(int srcoff, T[] dst) Absolute bulk get copies dst.length values from the specified offset into the slice defined by this buffer into the caller's array.
void	get(int srcoff, T[] dst, int dstoff, int dstlen) Absolute bulk get copies the specified slice of values from this buffer into the specified slice of the caller's array.
int	len() The length of the slice in the array().
int	off() The start of the slice in the array().
void	put(int pos, T v) Absolute put of a value at an index.
void	put(int pos, T[] src) Absolute bulk put copies all values in the caller's array into this buffer starting at the specified position within the slice defined by this buffer.
void	put(int dstoff, T[] src, int srcoff, int srclen) Absolute bulk put copies the specified slice of values from the caller's array into this buffer starting at the specified position within the slice defined by this buffer.
IArraySlice<T>	slice(int off, int len) Return a slice of the backing buffer.
T[]	toArray() Return a copy of the data in the slice.

Methods inherited from interface java.lang.Iterable

iterator

Method Detail

array

T[] array()

The backing array. This method DOES NOT guarantee that the backing array reference will remain constant. Some implementations use an extensible backing array and will replace the reference when the backing buffer is extended.

off

int off()

The start of the slice in the array().

len

int len()

The length of the slice in the array().

toArray

T[] toArray()

Return a copy of the data in the slice.

Returns:

A new array containing data in the slice.

slice

IArraySlice<T> slice(int off,
                   int len)

Return a slice of the backing buffer. The slice will always reference the current backing array(), even when the buffer is extended and the array reference is replaced.

Parameters:

off - The starting offset into the backing buffer of the slice.

len - The length of that slice.

Returns:

The slice.

put

void put(int pos,
       T v)

Absolute put of a value at an index.

Parameters:

pos - The index.

v - The value.

get

T get(int pos)

Absolute get of a value at an index.

Parameters:

pos - The index.

Returns:

The value.

put

void put(int pos,
       T[] src)

Absolute bulk put copies all values in the caller's array into this buffer starting at the specified position within the slice defined by this buffer.

Parameters:

pos - The starting position within the slice defined by this buffer.

src - The source data.

put

void put(int dstoff,
       T[] src,
       int srcoff,
       int srclen)

Absolute bulk put copies the specified slice of values from the caller's array into this buffer starting at the specified position within the slice defined by this buffer.

Parameters:

dstoff - The offset into the slice to which the data will be copied.

src - The source data.

srcoff - The offset of the 1st value in the source data to be copied.

srclen - The #of values to be copied.

get

void get(int srcoff,
       T[] dst)

Absolute bulk get copies dst.length values from the specified offset into the slice defined by this buffer into the caller's array.

Parameters:

srcoff - The offset into the slice of the first value to be copied.

dst - The array into which the data will be copied.

get

void get(int srcoff,
       T[] dst,
       int dstoff,
       int dstlen)

Absolute bulk get copies the specified slice of values from this buffer into the specified slice of the caller's array.

Parameters:

srcoff - The offset into the slice defined by this buffer of the first value to be copied.

dst - The array into which the data will be copied.

dstoff - The offset of the first value in that array onto which the data will be copied.

dstlen - The #of values to be copied.