ucar.nc2.iosp

Class IospArrayHelper

java.lang.Object

ucar.nc2.iosp.IospArrayHelper

public class IospArrayHelper
extends Object

Helper methods for IOSP's for reading data.

Constructor Summary

Constructors

Constructor and Description
IospArrayHelper()

Method Summary

Modifier and Type	Method and Description
static char[]	convertByteToChar(byte[] byteArray)
static char[]	convertByteToCharUTF(byte[] byteArray)
static byte[]	convertCharToByte(char[] from)
static byte[]	convertCharToByteUTF(char[] from)
static Object	makePrimitiveArray(int size, ArrayType ArrayType) Create 1D primitive array of the given size and type
static Object	makePrimitiveArray(int size, ArrayType ArrayType, Object fillValue) Create 1D primitive array of the given size and type, fill it with the given value
static Object	readData(LayoutBB layout, ArrayType ArrayType, Object arr) Read data subset from ByteBuffer, place in given primitive array.
static Object	readData(PositioningDataInputStream raf, Layout index, ArrayType ArrayType, Object arr) Read data subset from PositioningDataInputStream, place in given primitive array.
static Object	readData(RandomAccessFile raf, Layout layout, ArrayType ArrayType, Object arr, ByteOrder byteOrder, boolean convertChar) Read data subset from RandomAccessFile, place in given primitive array.
static Object	readDataFill(LayoutBB layout, ArrayType ArrayType, Object fillValue) Read data subset from ByteBuffer, create primitive array of size Layout.getTotalNelems.
static Object	readDataFill(PositioningDataInputStream is, Layout index, ArrayType ArrayType, Object fillValue) Read data subset from PositioningDataInputStream, create primitive array of size Layout.getTotalNelems.
static Object	readDataFill(RandomAccessFile raf, Layout index, ArrayType ArrayType, Object fillValue, ByteOrder byteOrder) Read data subset from RandomAccessFile, create primitive array of size Layout.getTotalNelems.
static Object	readDataFill(RandomAccessFile raf, Layout index, ArrayType ArrayType, Object fillValue, ByteOrder byteOrder, boolean convertChar)

Methods inherited from class java.lang.Object

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

Constructor Detail

IospArrayHelper

public IospArrayHelper()

Method Detail

readDataFill

public static Object readDataFill(RandomAccessFile raf,
                                  Layout index,
                                  ArrayType ArrayType,
                                  Object fillValue,
                                  ByteOrder byteOrder)
                           throws IOException

Read data subset from RandomAccessFile, create primitive array of size Layout.getTotalNelems. Reading is controlled by the Layout object.

Parameters:

raf - read from here.

index - handles skipping around in the file.

ArrayType - ArrayType of the variable

fillValue - must be Number if ArrayType.isNumeric(), or String for STRING, byte[] for Structure, or null for none

byteOrder - if equal to RandomAccessFile.ORDER_XXXX, set the byte order just before reading

Returns:

primitive array with data read in

Throws:

IOException - on read error

readDataFill

public static Object readDataFill(RandomAccessFile raf,
                                  Layout index,
                                  ArrayType ArrayType,
                                  Object fillValue,
                                  ByteOrder byteOrder,
                                  boolean convertChar)
                           throws IOException

Throws:

IOException

readData

public static Object readData(RandomAccessFile raf,
                              Layout layout,
                              ArrayType ArrayType,
                              Object arr,
                              ByteOrder byteOrder,
                              boolean convertChar)
                       throws IOException

Read data subset from RandomAccessFile, place in given primitive array. Reading is controlled by the Layout object.

Parameters:

raf - read from here.

layout - handles skipping around in the file.

ArrayType - ArrayType of the variable

arr - primitive array to read data into

byteOrder - if equal to RandomAccessFile.ORDER_XXXX, set the byte order just before reading

convertChar - true if bytes should be converted to char for ArrayType CHAR

Returns:

primitive array with data read in

Throws:

IOException - on read error

readDataFill

public static Object readDataFill(PositioningDataInputStream is,
                                  Layout index,
                                  ArrayType ArrayType,
                                  Object fillValue)
                           throws IOException

Read data subset from PositioningDataInputStream, create primitive array of size Layout.getTotalNelems. Reading is controlled by the Layout object.

Parameters:

is - read from here.

index - handles skipping around in the file.

ArrayType - ArrayType of the variable

fillValue - must be Number if ArrayType.isNumeric(), or String for STRING, byte[] for Structure, or null for none

Returns:

primitive array with data read in

Throws:

IOException - on read error

readData

public static Object readData(PositioningDataInputStream raf,
                              Layout index,
                              ArrayType ArrayType,
                              Object arr)
                       throws IOException

Read data subset from PositioningDataInputStream, place in given primitive array. Reading is controlled by the Layout object.

Parameters:

raf - read from here.

index - handles skipping around in the file.

ArrayType - ArrayType of the variable

arr - primitive array to read data into

Returns:

primitive array with data read in

Throws:

IOException - on read error

readDataFill

public static Object readDataFill(LayoutBB layout,
                                  ArrayType ArrayType,
                                  Object fillValue)

Read data subset from ByteBuffer, create primitive array of size Layout.getTotalNelems. Reading is controlled by the Layout object.

Parameters:

layout - handles skipping around in the file, provide ByteBuffer to read from

ArrayType - ArrayType of the variable

fillValue - must be Number if ArrayType.isNumeric(), or String for STRING, byte[] for Structure, or null for none

Returns:

primitive array with data read in

readData

public static Object readData(LayoutBB layout,
                              ArrayType ArrayType,
                              Object arr)

Read data subset from ByteBuffer, place in given primitive array. Reading is controlled by the LayoutBB object.

Parameters:

layout - handles skipping around in the file, privide ByteBuffer to read from

ArrayType - ArrayType of the variable

arr - primitive array to read data into

Returns:

the primitive array with data read in

makePrimitiveArray

public static Object makePrimitiveArray(int size,
                                        ArrayType ArrayType)

Create 1D primitive array of the given size and type

Parameters:

size - the size of the array to create

ArrayType - ArrayType of the variable

Returns:

primitive array with data read in

makePrimitiveArray

public static Object makePrimitiveArray(int size,
                                        ArrayType ArrayType,
                                        Object fillValue)

Create 1D primitive array of the given size and type, fill it with the given value

Parameters:

size - the size of the array to create

ArrayType - ArrayType of the variable

fillValue - must be Number if ArrayType.isNumeric(), or String for STRING, byte[] for Structure, or null for none

Returns:

primitive array with data read in

convertByteToCharUTF

public static char[] convertByteToCharUTF(byte[] byteArray)

convertCharToByteUTF

public static byte[] convertCharToByteUTF(char[] from)

convertByteToChar

public static char[] convertByteToChar(byte[] byteArray)

convertCharToByte

public static byte[] convertCharToByte(char[] from)