nom.tam.fits

Class FitsUtil

java.lang.Object

nom.tam.fits.FitsUtil

public final class FitsUtil
extends Object

This class comprises static utility functions used throughout the FITS classes.

Method Summary

Modifier and Type	Method and Description
static int	addPadding(int size)
static long	addPadding(long size)
static String[]	byteArrayToStrings(byte[] bytes, int maxLen)
static long	findOffset(Closeable o)
static InputStream	getURLStream(URL url, int level)
static int	maxLength(String[] strings)
static void	pad(ArrayDataOutput stream, long size) Add padding to an output stream.
static void	pad(ArrayDataOutput stream, long size, byte fill) Add padding to an output stream.
static int	padding(int size)
static int	padding(long size)
static void	reposition(Closeable o, long offset) Reposition a random access stream to a requested offset.
static byte[]	stringsToByteArray(String[] stringArray, int maxLen) Convert an array of Strings to bytes.

Methods inherited from class java.lang.Object

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

Method Detail

addPadding

public static int addPadding(int size)

Parameters:

size - the current size.

Returns:

Total size of blocked FITS element, using e.v. padding to fits block size.

addPadding

public static long addPadding(long size)

Parameters:

size - the current size.

Returns:

Total size of blocked FITS element, using e.v. padding to fits block size.

byteArrayToStrings

public static String[] byteArrayToStrings(byte[] bytes,
                                          int maxLen)

Parameters:

bytes - byte array to convert

maxLen - the max string length

Returns:

Convert bytes to Strings.

findOffset

public static long findOffset(Closeable o)

Parameters:

o - the stream to get the position

Returns:

Find out where we are in a random access file .

getURLStream

public static InputStream getURLStream(URL url,
                                       int level)
                                throws IOException

Parameters:

url - the url to get the stream from

level - max levels of redirection

Returns:

Get a stream to a URL accommodating possible redirections. Note that if a redirection request points to a different protocol than the original request, then the redirection is not handled automatically.

Throws:

IOException - if the operation failed

maxLength

public static int maxLength(String[] strings)
                     throws FitsException

Parameters:

strings - array of strings to check

Returns:

Get the maximum length of a String in a String array.

Throws:

FitsException - if the operation failed

pad

public static void pad(ArrayDataOutput stream,
                       long size)
                throws FitsException

Add padding to an output stream.

Parameters:

stream - stream to pad

size - the current size

Throws:

FitsException - if the operation failed

pad

public static void pad(ArrayDataOutput stream,
                       long size,
                       byte fill)
                throws FitsException

Add padding to an output stream.

Parameters:

stream - stream to pad

size - the current size

fill - the fill byte to use

Throws:

FitsException - if the operation failed

padding

public static int padding(int size)

Parameters:

size - the size without padding

Returns:

How many bytes are needed to fill a 2880 block?

padding

public static int padding(long size)

reposition

public static void reposition(Closeable o,
                              long offset)
                       throws FitsException

Reposition a random access stream to a requested offset.

Parameters:

o - the closable to reposition

offset - the offset to position it to.

Throws:

FitsException - if the operation was failed or not possible

stringsToByteArray

public static byte[] stringsToByteArray(String[] stringArray,
                                        int maxLen)

Convert an array of Strings to bytes.

Parameters:

stringArray - the array with Strings

maxLen - the max length (in bytes) of every String

Returns:

the resulting bytes