Indexer (JavaCPP 1.5.6 API)

java.lang.Object
- org.bytedeco.javacpp.indexer.Indexer

All Implemented Interfaces:

AutoCloseable

Direct Known Subclasses:

Bfloat16Indexer, BooleanIndexer, ByteIndexer, CharIndexer, DoubleIndexer, FloatIndexer, HalfIndexer, IntIndexer, LongIndexer, ShortIndexer, UByteIndexer, UIntIndexer, ULongIndexer, UShortIndexer
```
public abstract class Indexer
extends Object
implements AutoCloseable
```
Top-level class of all data indexers, providing easy-to-use and efficient multidimensional access to primitive arrays, NIO buffers, and the raw memory interface.
Subclasses have create() factory methods for arrays, buffers, and pointers. The latter ones feature a direct argument that, when set to false, instructs the method to create a large enough array, fill its content with the data from the pointer, and return an array-backed indexer, with the release() method overridden to write back changes to the pointer. This doubles the memory usage, but is the only way to get acceptable performance on some implementations, such as Android. When direct == true, the raw memory interface (supporting long indexing) is used if available, and if not a buffer-backed indexer is returned.

Author:

Samuel Audet

See Also:

Raw

Field Summary

Fields
Modifier and Type	Field and Description
`protected Index`	`index` The Index to be used for `index(long...)`.
`protected Indexable`	`indexable` The associated (optional) `Indexable`.
`protected long[]`	`sizes` Deprecated.
`protected long[]`	`strides` Deprecated.

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`Indexer(Index index)` Constructor to set the `index`.
`protected`	`Indexer(long[] sizes, long[] strides)` Calls `Indexer(Index.create(sizes, strides))`.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`Object`	`array()` Returns the backing array, or `null` if none
`Buffer`	`buffer()` Returns the backing buffer, or `null` if none
`long`	`channels()` Deprecated.
`protected static long`	`checkIndex(long i, long size)`
`void`	`close()` Calls `release()`.
`long`	`cols()` Deprecated.
`abstract double`	`getDouble(long... indices)` Calls `get(int...indices)` and returns the value as a double.
`long`	`height()` Deprecated.
`long`	`index(long... indices)` Returns `index.index(indices)`.
`long`	`index(long i)` Returns `index.index(i)`.
`long`	`index(long i, long j)` Returns `index.index(i, j)`.
`long`	`index(long i, long j, long k)` Returns `index.index(i, j, k)`.
`Indexable`	`indexable()` Returns `indexable`.
`Indexer`	`indexable(Indexable indexable)` Sets `indexable` and returns this.
`Pointer`	`pointer()` Returns the backing pointer, or `null` if none
`abstract Indexer`	`putDouble(long[] indices, double value)` Casts value to primitive type and calls `put(long[] indices, <type> value)`.
`int`	`rank()` Returns `index.rank()`.
`abstract <I extends Indexer> I`	`reindex(Index index)` Returns a new Indexer using the same data, but with a different Index.
`abstract void`	`release()` Makes sure changes are reflected onto the backing memory and clears any references.
`long`	`rows()` Deprecated.
`long`	`size(int i)` Returns `index.size(i)`.
`long[]`	`sizes()` Returns `index.sizes()`.
`long`	`stride(int i)` Deprecated.
`long[]`	`strides()` Deprecated.
`static long[]`	`strides(long... sizes)` Deprecated.
`String`	`toString()`
`long`	`width()` Deprecated.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - sizes
```
@Deprecated
protected long[] sizes
```
    Deprecated.
    
    See Index.sizes.
  - strides
```
@Deprecated
protected long[] strides
```
    Deprecated.
    
    See StrideIndex.strides.
  - index
```
protected final Index index
```
    The Index to be used for index(long...).
  - indexable
```
protected Indexable indexable
```
    The associated (optional) Indexable.
- Constructor Detail
  - Indexer
```
protected Indexer(Index index)
```
    Constructor to set the index.
  - Indexer
```
protected Indexer(long[] sizes,
                  long[] strides)
```
    Calls Indexer(Index.create(sizes, strides)).
- Method Detail
  - close
```
public void close()
```
    Calls release().
    
    Specified by:
    
    close in interface AutoCloseable
  - rank
```
public int rank()
```
    Returns index.rank().
  - sizes
```
public long[] sizes()
```
    Returns index.sizes().
  - strides
```
@Deprecated
public long[] strides()
```
    Deprecated.
    
    Returns strides or null if there are no strides.
  - size
```
public long size(int i)
```
    Returns index.size(i).
  - stride
```
@Deprecated
public long stride(int i)
```
    Deprecated.
    
    Returns strides[i] or -1 if there are no strides.
  - rows
```
@Deprecated
public long rows()
```
    Deprecated.
    
    Returns sizes.length > 0 && sizes.length < 4 ? sizes[0] : -1.
  - cols
```
@Deprecated
public long cols()
```
    Deprecated.
    
    Returns sizes.length > 1 && sizes.length < 4 ? sizes[1] : -1.
  - width
```
@Deprecated
public long width()
```
    Deprecated.
    
    Returns sizes.length > 1 && sizes.length < 4 ? sizes[1] : -1.
  - height
```
@Deprecated
public long height()
```
    Deprecated.
    
    Returns sizes.length > 0 && sizes.length < 4 ? sizes[0] : -1.
  - channels
```
@Deprecated
public long channels()
```
    Deprecated.
    
    Returns sizes.length > 2 && sizes.length < 4 ? sizes[2] : -1.
  - checkIndex
```
protected static final long checkIndex(long i,
                                       long size)
```
  - strides
```
@Deprecated
public static long[] strides(long... sizes)
```
    Deprecated.
    
    See StrideIndex.defaultStrides(long...).
  - index
```
public long index(long i)
```
    Returns index.index(i).
  - index
```
public long index(long i,
                  long j)
```
    Returns index.index(i, j).
  - index
```
public long index(long i,
                  long j,
                  long k)
```
    Returns index.index(i, j, k).
  - index
```
public long index(long... indices)
```
    Returns index.index(indices).
  - indexable
```
public Indexable indexable()
```
    Returns indexable.
  - indexable
```
public Indexer indexable(Indexable indexable)
```
    Sets indexable and returns this.
  - array
```
public Object array()
```
    Returns the backing array, or null if none
  - buffer
```
public Buffer buffer()
```
    Returns the backing buffer, or null if none
  - pointer
```
public Pointer pointer()
```
    Returns the backing pointer, or null if none
  - release
```
public abstract void release()
```
    Makes sure changes are reflected onto the backing memory and clears any references.
  - getDouble
```
public abstract double getDouble(long... indices)
```
    Calls get(int...indices) and returns the value as a double.
  - putDouble
```
public abstract Indexer putDouble(long[] indices,
                                  double value)
```
    Casts value to primitive type and calls put(long[] indices, <type> value).
  - reindex
```
public abstract <I extends Indexer> I reindex(Index index)
```
    Returns a new Indexer using the same data, but with a different Index.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class Indexer

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

sizes

strides

index

indexable

Constructor Detail

Indexer

Indexer

Method Detail

close

rank

sizes

strides

size

stride

rows

cols

width

height

channels

checkIndex

strides

index

index

index

index

indexable

indexable

array

buffer

pointer

release

getDouble

putDouble

reindex

toString