Package org.esa.snap.core.datamodel

Class ProductData.Long

java.lang.Object

org.esa.snap.core.datamodel.ProductData

org.esa.snap.core.datamodel.ProductData.Long

All Implemented Interfaces:

Cloneable

Enclosing class:

ProductData

public static class ProductData.Long
extends ProductData

The Long class is a ProductData specialisation for signed 64-bit integer fields.

Internally, data is stored in an array of the type long[].

Nested Class Summary

Nested classes/interfaces inherited from class org.esa.snap.core.datamodel.ProductData

ProductData.ASCII, ProductData.Byte, ProductData.Double, ProductData.Float, ProductData.Int, ProductData.Long, ProductData.Short, ProductData.UByte, ProductData.UInt, ProductData.UShort, ProductData.UTC

Field Summary

Fields

Modifier and Type	Field	Description
protected long[]	_array	The internal data array holding this value's data elements.

Fields inherited from class org.esa.snap.core.datamodel.ProductData

TYPE_ASCII, TYPE_FLOAT32, TYPE_FLOAT64, TYPE_INT16, TYPE_INT32, TYPE_INT64, TYPE_INT8, TYPE_UINT16, TYPE_UINT32, TYPE_UINT64, TYPE_UINT8, TYPE_UNDEFINED, TYPE_UTC, TYPESTRING_ASCII, TYPESTRING_FLOAT32, TYPESTRING_FLOAT64, TYPESTRING_INT16, TYPESTRING_INT32, TYPESTRING_INT64, TYPESTRING_INT8, TYPESTRING_UINT16, TYPESTRING_UINT32, TYPESTRING_UINT64, TYPESTRING_UINT8, TYPESTRING_UTC

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Long(int numElems)	Constructs a new long instance.
protected	Long(long[] array)	Constructs a new Long instance.

Method Summary

Modifier and Type	Method	Description
protected ProductData	createDeepClone()	Returns a "deep" copy of this product data.
void	dispose()	Releases all of the resources used by this object instance and all of its owned children.
long[]	getArray()	Returns the internal data array holding this value's data elements.
double	getElemDoubleAt(int index)	Please refer to ProductData.getElemDoubleAt(int).
float	getElemFloatAt(int index)	Please refer to ProductData.getElemFloatAt(int).
int	getElemIntAt(int index)	Please refer to ProductData.getElemIntAt(int).
long	getElemLongAt(int index)	Please refer to ProductData.getElemLongAt(int).
Object	getElems()	Gets the actual value value(s).
String	getElemStringAt(int index)	Please refer to ProductData.getElemStringAt(int).
long	getElemUIntAt(int index)	Please refer to ProductData.getElemUIntAt(int).
int	getNumElems()	Returns the number of data elements this value has.
void	readFrom(int startPos, int numElems, ImageInputStream source)	Please refer to ProductData.readFrom(int, int, ImageInputStream).
void	setElemDoubleAt(int index, double value)	Please refer to ProductData.setElemDoubleAt(int, double).
void	setElemFloatAt(int index, float value)	Please refer to ProductData.setElemFloatAt(int, float).
void	setElemIntAt(int index, int value)	Please refer to ProductData.setElemIntAt(int, int).
void	setElemLongAt(int index, long value)	Please refer to ProductData.setElemLongAt(int, long).
void	setElems(Object data)	Sets the data of this value.
void	setElemUIntAt(int index, long value)	Please refer to ProductData.setElemUIntAt(int, long).
void	writeTo(int sourceStartPos, int numSourceElems, ImageOutputStream destination)	Please refer to ProductData.writeTo(int, int, ImageOutputStream).

Methods inherited from class org.esa.snap.core.datamodel.ProductData

createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createInstance, createUnsignedInstance, createUnsignedInstance, createUnsignedInstance, equalElems, equals, getElemBoolean, getElemBooleanAt, getElemDouble, getElemFloat, getElemInt, getElemLong, getElemSize, getElemSize, getElemString, getElemUInt, getType, getType, getTypeString, getTypeString, hashCode, isFloatingPointType, isInt, isIntType, isScalar, isSigned, isUIntType, isUnsigned, readFrom, readFrom, readFrom, setElemBoolean, setElemBooleanAt, setElemDouble, setElemFloat, setElemInt, setElemLong, setElemString, setElemStringAt, setElemUInt, toString, writeTo, writeTo, writeTo

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

_array

protected long[] _array

The internal data array holding this value's data elements.

Constructor Detail

Long

protected Long(int numElems)

Constructs a new long instance.

Parameters:

numElems - the number of elements, must not be less than one

Long

protected Long(long[] array)

Constructs a new Long instance.

Parameters:

array - the elements

Method Detail

createDeepClone

protected ProductData createDeepClone()

Returns a "deep" copy of this product data.

Specified by:

createDeepClone in class ProductData

Returns:

a copy of this product data

getNumElems

public int getNumElems()

Returns the number of data elements this value has.

Specified by:

getNumElems in class ProductData

getElemIntAt

public int getElemIntAt(int index)

Please refer to ProductData.getElemIntAt(int).

Specified by:

getElemIntAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

getElemUIntAt

public long getElemUIntAt(int index)

Please refer to ProductData.getElemUIntAt(int).

Specified by:

getElemUIntAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

getElemLongAt

public long getElemLongAt(int index)

Please refer to ProductData.getElemLongAt(int).

Specified by:

getElemLongAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

getElemFloatAt

public float getElemFloatAt(int index)

Please refer to ProductData.getElemFloatAt(int).

Specified by:

getElemFloatAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

getElemDoubleAt

public double getElemDoubleAt(int index)

Please refer to ProductData.getElemDoubleAt(int).

Specified by:

getElemDoubleAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

getElemStringAt

public String getElemStringAt(int index)

Please refer to ProductData.getElemStringAt(int).

Specified by:

getElemStringAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

setElemIntAt

public void setElemIntAt(int index,
                         int value)

Please refer to ProductData.setElemIntAt(int, int).

Specified by:

setElemIntAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

value - the value to be set

setElemUIntAt

public void setElemUIntAt(int index,
                          long value)

Please refer to ProductData.setElemUIntAt(int, long).

Specified by:

setElemUIntAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

value - the value to be set

setElemLongAt

public void setElemLongAt(int index,
                          long value)

Please refer to ProductData.setElemLongAt(int, long).

Specified by:

setElemLongAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

value - the value to be set

setElemFloatAt

public void setElemFloatAt(int index,
                           float value)

Please refer to ProductData.setElemFloatAt(int, float).

Specified by:

setElemFloatAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

value - the value to be set

setElemDoubleAt

public void setElemDoubleAt(int index,
                            double value)

Please refer to ProductData.setElemDoubleAt(int, double).

Specified by:

setElemDoubleAt in class ProductData

Parameters:

index - the value index, must be >=0 and <getNumDataElems()

value - the value to be set

getArray

public final long[] getArray()

Returns the internal data array holding this value's data elements.

Returns:

the internal data array, never null

getElems

public Object getElems()

Gets the actual value value(s). The value returned can safely been casted to an array object of the type int[].

Specified by:

getElems in class ProductData

Returns:

this value's value, always a int[], never null

setElems

public void setElems(Object data)

Sets the data of this value. The data must be an array of the type int[] or String[] and have a length that is equal to the value returned by the getNumDataElems method.

Specified by:

setElems in class ProductData

Parameters:

data - the data array

Throws:

IllegalArgumentException - if data is null or it is not an array of the required type or does not have the required array length.

readFrom

public void readFrom(int startPos,
                     int numElems,
                     ImageInputStream source)
              throws IOException

Please refer to ProductData.readFrom(int, int, ImageInputStream).

Specified by:

readFrom in class ProductData

Parameters:

startPos - the destination start position (zero-based)

numElems - the number of elements to read

source - a seekable data input stream

Throws:

IOException - if an I/O error occurs

writeTo

public void writeTo(int sourceStartPos,
                    int numSourceElems,
                    ImageOutputStream destination)
             throws IOException

Please refer to ProductData.writeTo(int, int, ImageOutputStream).

Specified by:

writeTo in class ProductData

Parameters:

sourceStartPos - the source start position (zero-based)

numSourceElems - the number of elements to be written

destination - a seekable data output stream

Throws:

IOException - if an I/O error occurs

dispose

public void dispose()

Releases all of the resources used by this object instance and all of its owned children. Its primary use is to allow the garbage collector to perform a vanilla job.

This method should be called only if it is for sure that this object instance will never be used again. The results of referencing an instance of this class after a call to dispose() are undefined.

Overrides of this method should always call super.dispose(); after disposing this instance.

Specified by:

dispose in class ProductData