Package hdf.hdf5lib

Class HDFArray

java.lang.Object

hdf.hdf5lib.HDFArray

public class HDFArray
extends Object

Constructor Summary

Constructors

Constructor	Description
HDFArray(Object anArray)	The input must be a Java Array (possibly multidimensional) of primitive numbers or sub-classes of Number.

Method Summary

Modifier and Type	Method	Description
Object	arrayify(byte[] bytes)	Given a one-dimensional array of bytes representing numbers, convert it to a java array of the shape and size passed to the constructor.
byte[]	byteify()	Given a Java array of numbers, convert it to a one-dimensional array of bytes in correct native order.
byte[]	emptyBytes()	Allocate a one-dimensional array of bytes sufficient to store the array.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HDFArray

public HDFArray(Object anArray)
         throws HDF5JavaException

The input must be a Java Array (possibly multidimensional) of primitive numbers or sub-classes of Number.

The input is analysed to determine the number of dimensions and size of each dimension, as well as the type of the elements.

The description is saved in private variables, and used to convert data.

Parameters:

anArray - The array object.

Throws:

HDF5JavaException - object is not an array.

Method Detail

emptyBytes

public byte[] emptyBytes()
                  throws HDF5JavaException

Allocate a one-dimensional array of bytes sufficient to store the array.

Returns:

A one-D array of bytes, filled with zeroes. The bytes are sufficient to hold the data of the Array passed to the constructor.

Throws:

HDF5JavaException - Allocation failed.

byteify

public byte[] byteify()
               throws HDF5JavaException

Given a Java array of numbers, convert it to a one-dimensional array of bytes in correct native order.

Returns:

A one-D array of bytes, constructed from the Array passed to the constructor.

Throws:

HDF5JavaException - the object not an array or other internal error.

arrayify

public Object arrayify(byte[] bytes)
                throws HDF5JavaException

Given a one-dimensional array of bytes representing numbers, convert it to a java array of the shape and size passed to the constructor.

Parameters:

bytes - The bytes to construct the Array.

Returns:

An Array (possibly multidimensional) of primitive or number objects.

Throws:

HDF5JavaException - the object not an array or other internal error.