TINE Data Type object All data transfered client <-> server must be contained in a TDataType object. More...

Public Member Functions
void	setArrayDelimiter (String delimiter)
	Sets the delimiter used in a string representation of an array.
String	getArrayDelimiter ()
	Get the delimiter used in a string representation of an array.
	TDataType ()
	NULL element.
	TDataType (int dataSize, short dataFormat)
	An unbound DataType object of the specified size and format.
int	getTimeStamp ()
	Returns the associated data timestamp as traditional UNIX timestamp (seconds since 1.1.1970).
long	getDataTimeStamp ()
	Returns the associated data timestamp as JAVA timestamp (milliseconds since 1.1.1970).
void	setDataTimeStamp (long TimeStamp)
	Sets the associated data timestamp from a JAVA timestamp (milliseconds since 1.1.1970).
void	setDataTimeStamp (double TimeStamp)
	Sets the associated data timestamp from a TINE timestamp (seconds since 1.1.1970 + fractional seconds).
int	getLastDataSize ()
	Returns the associated data completion length.
	TDataType (byte[] data)
	A subset of an array of booleans.
	TDataType (byte[] data, int length)
	A subset of an array of bytes.
	TDataType (byte[] data, String tag)
	An array of 'structs' with the given tag or untagged structs if tag.length == 0 User-defined structures are allowed in tine and not too difficult to use.
	TDataType (TTaggedStructure data)
	A Tagged Structure User-defined structures are allowed in tine and not too difficult to use.
	TDataType (TTaggedStructure[] data)
	A array of Tagged Structures User-defined structures are allowed in tine and not too difficult to use.
	TDataType (short[] data)
	An array of shorts (2-byte integers) This corresponds to tine format CF_SHORT.
	TDataType (short[] data, int length)
	A subset of an array of shorts (2-byte integers) This corresponds to tine format CF_SHORT.
	TDataType (short data)
	A single short value This method is only useful for quick creation of data 'down' objects (i.e.
	TDataType (int[] data)
	An array of ints (4-byte integers) This corresponds to tine format CF_LONG.
	TDataType (int[] data, int length)
	A subset of an array of ints (4-byte integers) This corresponds to tine format CF_LONG.
	TDataType (boolean[] data)
	A subset of an array of booleans.
	TDataType (boolean[] data, int length)
	A subset of an array of booleans.
	TDataType (float[] data)
	An array of floats This corresponds to tine format CF_FLOAT.
	TDataType (float[] data, int length)
	A subset of an array of floats This corresponds to tine format CF_FLOAT.
	TDataType (TCompoundDataObject[] data)
	An array of tine data objects (e.g.
	TDataType (TCompoundDataObject[] data, int length)
	An array of tine data objects (e.g.
	TDataType (SPECTRUM data)
	A SPECTRUM object.
	TDataType (IMAGE data)
	An IMAGE object.
	TDataType (double[] data)
	An array of doubles.
	TDataType (double[] data, int length)
	A subset of an array of doubles.
	TDataType (long[] data)
	An array of (Java) longs.
	TDataType (long[] data, int length)
	A subset of an array of (java) longs.
int	getData (byte[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (byte[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (short[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (short[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	putData (short data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (short[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (short[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (short value, int offset)
	Puts the input data value into the underlying byte stream, properly swapped and aligned.
int	putData (short[] values, int offset)
	Puts the input data value array into the underlying byte stream, properly swapped and aligned.
int	getData ()
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (boolean[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (boolean[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (int[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (int[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	putData (boolean data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (boolean[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (boolean[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (boolean value, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data value into the underlying byte stream, properly swapped and aligned.
int	putData (int data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (int[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (int[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (int value, int offset)
	Puts the input data value into the underlying byte stream, properly swapped and aligned.
int	putData (int[] values, int offset)
	Puts the input data value array into the underlying byte stream, properly swapped and aligned.
int	getData (float[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (float[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (TTaggedStructure[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (TTaggedStructure[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (TCompoundDataObject[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (TCompoundDataObject[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (SPECTRUM data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (IMAGE image)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	putData (float data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData ()
	Puts the current canonical data set into the underlying data byte stream Puts the currently referenced canonical data set into the underlying byte stream, properly swapped and aligned.
int	putData (float[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (float[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (float value, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data value into the underlying byte stream, properly swapped and aligned.
int	putData (float[] values, int offset)
	Puts the input data value array into the underlying byte stream, properly swapped and aligned.
int	putData (FLTINT data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (FLTINT[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (FLTINT[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (NAME16FI[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (NAME16FI[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (NAME32DBLDBL[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (NAME32DBLDBL[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (INTINT data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (INTINT[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (INTINT[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (DBLDBL data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (DBLDBL[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (DBLDBL[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (DBLDBLDBL data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (DBLDBLDBL[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (DBLDBLDBL[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (String[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (String[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (KEYVALUE[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (KEYVALUE[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (String data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (TTaggedStructure data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (TTaggedStructure[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (TTaggedStructure[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (byte[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (byte[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (byte value, int offset)
	Puts the input data value into the underlying byte stream, properly swapped and aligned.
int	putData (byte[] values, int offset)
	Puts the input data value array into the underlying byte stream, properly swapped and aligned.
int	putData (IMAGE data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (TCompoundDataObject data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (TCompoundDataObject[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (TCompoundDataObject[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (TCompoundDataObject value, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data value into the underlying byte stream, properly swapped and aligned.
int	getData (double[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (double[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	putData (double data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (double[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (double[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (double value, int offset)
	Puts the input data value into the underlying byte stream, properly swapped and aligned.
int	putData (double[] values, int offset)
	Puts the input data value array into the underlying byte stream, properly swapped and aligned.
int	getData (long[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (long[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	putData (long data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (long[] data)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (long[] data, int length, int offset)
	Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.
int	putData (long value, int offset)
	Puts the input data value into the underlying byte stream, properly swapped and aligned.
int	putData (long[] values, int offset)
	Puts the input data value array into the underlying byte stream, properly swapped and aligned.
int	getArrayLength ()
	Returns the data array length of the associated tine Data Type object.
short	getFormat ()
	Returns the data type of the associated tine Data Type object.
int	getData (Object Data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (Object Data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
Object	getDataObject ()
	Retrieves the returned data as an Object container.
Vector< Object >	getVector ()
	Retrieves the returned data as a Vector.
String	toString ()
	Outputs the returned data as a String.
	TDataType (char[] data)
	An array of chars (to be interpretted as a text string)
	TDataType (char[] data, int length)
	A subset of an array of chars (to be interpretted as a text string)
	TDataType (StringBuffer data)
	A text string buffer.
	TDataType (StringBuffer data, int length)
	A subset of a text string buffer.
	TDataType (String[] data)
	A subset of an array of Strings.
	TDataType (String[] data, int length)
	A subset of an array of Strings.
	TDataType (KEYVALUE[] data)
	A subset of an array of KEYVALUE Strings.
	TDataType (KEYVALUE[] data, int length)
	A subset of an array of KEYVALUE Strings.
	TDataType (String data)
	A text string.
	TDataType (String data, int length)
	A text string.
int	getData (char[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (StringBuffer data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (String[] data)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getData (String[] data, int length, int offset)
	Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.
int	getCompletionLength ()
	Returns the last data completion length.
Static Public Member Functions
static long	UnsignedInt (int ival)
	Converts a value transmitted as an 'unsigned' integer to a java signed long.
static int	UnsignedInt (long lval)
	Forms an 'equivalent' unsigned integer for transmission.
static int	UnsignedShort (short sval)
	Converts a value transmitted as an 'unsigned' short to a java signed integer.
static short	UnsignedShort (int ival)
	Forms an 'equivalent' unsigned short for transmission.
static TDataType	toTDataType (String text, String fmtstring)
	parse input string into a TDataType
static TDataType	toTDataType (String text, short fmtcode)
	parse input string into a TDataType

Detailed Description

TINE Data Type object All data transfered client <-> server must be contained in a TDataType object.

Furthermore all constructors of TDataType take an array of tine data types as input argument, i.e. a single element should be passed as an array of length 1

Constructor & Destructor Documentation

de.desy.tine.dataUtils.TDataType.TDataType	(	int	dataSize,
		short	dataFormat
	)

An unbound DataType object of the specified size and format.

Parameters:

dataSize	is the array size of the given format.
dataFormat	is the tine data type of the object to create.

Note:: A call to getData() must be made in order to retrieve the incoming data into the application array parameters.

de.desy.tine.dataUtils.TDataType.TDataType ( byte[] data )

A subset of an array of booleans.

This corresponds to tine format CF_BOOLEAN

Parameters:

data	is a reference to the boolean array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	byte[]	data,
		int	length
	)

A subset of an array of bytes.

Parameters:

data	is a reference to the byte array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType	(	byte[]	data,
		String	tag
	)

An array of 'structs' with the given tag or untagged structs if tag.length == 0 User-defined structures are allowed in tine and not too difficult to use.

It is strongly encouraged to make use of 'tagged' structures whereby the server and client both register the structure contents with the tine engine and apply a tag. Only then can issues of 'byte-swapping' and structure boundaries be handled correctly. As java does not have structures, the associated class is responsible for providing a toStruct() method which returns a byte stream containing the contents of the desired structure.

Parameters:

data	is a reference to the byte array stream containing the 'struct' used to create and bind to the TDataType object.
tag	is the structure tag associated with the 'struct.'

de.desy.tine.dataUtils.TDataType.TDataType ( TTaggedStructure data )

A Tagged Structure User-defined structures are allowed in tine and not too difficult to use.

It is strongly encouraged to make use of 'tagged' structures whereby the server and client both register the structure contents with the tine engine and apply a tag. Only then can issues of 'byte-swapping' and structure boundaries be handled correctly. As java does not have structures, the associated class is responsible for providing a toStruct() method which returns a byte stream containing the contents of the desired structure.

Parameters:

data	is a reference to a TTaggedStructure object.

de.desy.tine.dataUtils.TDataType.TDataType ( TTaggedStructure[] data )

A array of Tagged Structures User-defined structures are allowed in tine and not too difficult to use.

It is strongly encouraged to make use of 'tagged' structures whereby the server and client both register the structure contents with the tine engine and apply a tag. Only then can issues of 'byte-swapping' and structure boundaries be handled correctly. As java does not have structures, the associated class is responsible for providing a toStruct() method which returns a byte stream containing the contents of the desired structure.

Parameters:

data	is a reference to an array of TTaggedStructure object.

de.desy.tine.dataUtils.TDataType.TDataType ( short[] data )

An array of shorts (2-byte integers) This corresponds to tine format CF_SHORT.

Parameters:

data	is a reference to the short array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	short[]	data,
		int	length
	)

A subset of an array of shorts (2-byte integers) This corresponds to tine format CF_SHORT.

Parameters:

data	is a reference to the short array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( short data )

A single short value This method is only useful for quick creation of data 'down' objects (i.e.

data sets sent to the server). As there is no reference to the argument passed, it cannot be used to bind returning data to the object passed as the argument.

Parameters:

data	is a single short value used to create the TDataType object.

de.desy.tine.dataUtils.TDataType.TDataType ( int[] data )

An array of ints (4-byte integers) This corresponds to tine format CF_LONG.

Parameters:

data	is a reference to the int array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	int[]	data,
		int	length
	)

A subset of an array of ints (4-byte integers) This corresponds to tine format CF_LONG.

Parameters:

data	is a reference to the int array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( boolean[] data )

A subset of an array of booleans.

This corresponds to tine format CF_BOOLEAN

Parameters:

data	is a reference to the boolean array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	boolean[]	data,
		int	length
	)

A subset of an array of booleans.

This corresponds to tine format CF_BOOLEAN

Parameters:

data	is a reference to the boolean array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( float[] data )

An array of floats This corresponds to tine format CF_FLOAT.

Parameters:

data	is a reference to the float array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	float[]	data,
		int	length
	)

A subset of an array of floats This corresponds to tine format CF_FLOAT.

Parameters:

data	is a reference to the float array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( TCompoundDataObject[] data )

An array of tine data objects (e.g.

FLTINTs, FLTFLTs, NAME16s, etc.) can be bound to a tine data type object. Tine data type objects are used in data links between client and server.

Parameters:

data	is a reference to the data objects used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	TCompoundDataObject[]	data,
		int	length
	)

An array of tine data objects (e.g.

FLTINTs, FLTFLTs, NAME16s, etc.) can be bound to a tine data type object. Tine data type objects are used in data links between client and server.

Parameters:

data	is a reference to the data objects used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( SPECTRUM data )

A SPECTRUM object.

This corresponds to tine format CF_SPECTRUM

Parameters:

data	is a reference to the SPECTRUM object used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType ( IMAGE data )

An IMAGE object.

This corresponds to tine format CF_IMAGE

Parameters:

data	is a reference to the IMAGE object used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType ( double[] data )

An array of doubles.

This corresponds to tine format CF_DOUBLE

Parameters:

data	is a reference to the double array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	double[]	data,
		int	length
	)

A subset of an array of doubles.

This corresponds to tine format CF_DOUBLE

Parameters:

data	is a reference to the double array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( long[] data )

An array of (Java) longs.

This corresponds to tine format CF_DLONG or CF_INT64

Parameters:

data	is a reference to the long array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	long[]	data,
		int	length
	)

A subset of an array of (java) longs.

This corresponds to tine format CF_DLONG, CF_INT64

Parameters:

data	is a reference to the long array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( char[] data )

An array of chars (to be interpretted as a text string)

Parameters:

data	is a reference to the char[] array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	char[]	data,
		int	length
	)

A subset of an array of chars (to be interpretted as a text string)

Parameters:

data	is a reference to the char[] array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( StringBuffer data )

A text string buffer.

Parameters:

data	is a reference to the StringBuffer used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	StringBuffer	data,
		int	length
	)

A subset of a text string buffer.

Parameters:

data	is a reference to the StringBuffer used to create and bind to the TDataType object
length	is the subset length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( String[] data )

A subset of an array of Strings.

This corresponds to tine format CF_STRING

Parameters:

data	is a reference to the String array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	String[]	data,
		int	length
	)

A subset of an array of Strings.

This corresponds to tine format CF_STRING

Parameters:

data	is a reference to the String array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( KEYVALUE[] data )

A subset of an array of KEYVALUE Strings.

This corresponds to tine format CF_KEYVALUE

Parameters:

data	is a reference to the String array used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	KEYVALUE[]	data,
		int	length
	)

A subset of an array of KEYVALUE Strings.

This corresponds to tine format CF_KEYVALUE

Parameters:

data	is a reference to the KEYVALUE array used to create and bind to the TDataType object
length	is the subset array length to use.

de.desy.tine.dataUtils.TDataType.TDataType ( String data )

A text string.

Parameters:

data	is a reference to the String used to create and bind to the TDataType object

de.desy.tine.dataUtils.TDataType.TDataType	(	String	data,
		int	length
	)

A text string.

Parameters:

data	is a reference to the String used to create and bind to the TDataType object
length	is the subset length to use.

Member Function Documentation

String de.desy.tine.dataUtils.TDataType.getArrayDelimiter ( )

Get the delimiter used in a string representation of an array.

Returns:: the delimiter used in a string representation of an array

int de.desy.tine.dataUtils.TDataType.getArrayLength ( )

Returns the data array length of the associated tine Data Type object.

Returns:: Returns the data array length of the associated tine Data Type object

int de.desy.tine.dataUtils.TDataType.getCompletionLength ( )

Returns the last data completion length.

Returns:: the last data completion length. This can be different (smaller) than the data length used to construct the object.

int de.desy.tine.dataUtils.TDataType.getData	(	float[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( TTaggedStructure[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( long[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	long[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( float[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( TCompoundDataObject[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	TTaggedStructure[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	TCompoundDataObject[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( IMAGE image )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( Object Data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( SPECTRUM data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	Object	Data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( byte[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( char[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( StringBuffer data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	byte[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( String[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	String[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( short[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	short[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is mostly used internally, and is of little use to the API programmer.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( boolean[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	boolean[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( int[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	int[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData ( double[] data )

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.

Returns:: 0 on success or a tine error code

int de.desy.tine.dataUtils.TDataType.getData	(	double[]	data,
		int	length,
		int	offset
	)

Gets the canonical data set from the underlying data byte stream Gets the fully formed (properly assembled and byte-swapped) canonical data set from the underlying byte stream.

This method is used internally, but can be used to get the underlying data into the specifically referenced data, for instance when the TDataType object was instantiated with 'unbound' data.

Parameters:

data	is the data object into which the underlying data should be prepared and copied.
length	is the number of elements to get
offset	is the beginning position of the target data array into which the data should be copied

Returns:: 0 on success or a tine error code

Object de.desy.tine.dataUtils.TDataType.getDataObject ( )

Retrieves the returned data as an Object container.

This method is useful for obtaining the unbound data when the data type is unknown at link time. A call to getFormat() can be made to ascertain the tine data type and hence the array nature of the object returned.

short de.desy.tine.dataUtils.TDataType.getFormat ( )

Returns the data type of the associated tine Data Type object.

Returns:: Returns the data type of the associated tine Data Type object

Vector<Object> de.desy.tine.dataUtils.TDataType.getVector ( )

Retrieves the returned data as a Vector.

This method is useful for obtaining the unbound data when the data type is unknown at link time. A call to getFormat() can be made to ascertain the tine data type and hence the contents of the Vector.

int de.desy.tine.dataUtils.TDataType.putData ( String data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( TTaggedStructure[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( byte[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	KEYVALUE[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( KEYVALUE[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	String[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( String[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	long[]	values,
		int	offset
	)

Puts the input data value array into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

values	is the values array which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData ( DBLDBLDBL data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	DBLDBL[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( DBLDBL[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( double data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	INTINT[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( INTINT[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	int[]	values,
		int	offset
	)

Puts the input data value array into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

values	is the values array which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData	(	double[]	values,
		int	offset
	)

Puts the input data value array into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

values	is the values array which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData ( double[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( long[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	float[]	values,
		int	offset
	)

Puts the input data value array into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

values	is the values array which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData ( float[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( IMAGE data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is IMAGE type whose contents are to copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( TCompoundDataObject[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	TCompoundDataObject	value,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data value into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

value	is the single value which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData	(	float[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData	(	int	value,
		int	offset
	)

Puts the input data value into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

value	is the single value which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData	(	double	value,
		int	offset
	)

Puts the input data value into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

value	is the single value which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData ( float data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	NAME16FI[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( NAME32DBLDBL[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	int[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	float	value,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data value into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

value	is the single value which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData ( FLTINT data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	double[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( )

Puts the current canonical data set into the underlying data byte stream Puts the currently referenced canonical data set into the underlying byte stream, properly swapped and aligned.

This method is primarily used internally and is of little value to the API programmer.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	NAME32DBLDBL[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( INTINT data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( short data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( short[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( DBLDBL data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( int data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	TCompoundDataObject[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( TCompoundDataObject data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	boolean	value,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data value into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

value	is the single value which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData	(	short[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	byte[]	values,
		int	offset
	)

Puts the input data value array into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

values	is the values array which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData	(	byte	value,
		int	offset
	)

Puts the input data value into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

value	is the single value which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData	(	long	value,
		int	offset
	)

Puts the input data value into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

value	is the single value which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData ( TTaggedStructure data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is Tagged Structure whose contents are to be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( NAME16FI[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	TTaggedStructure[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	FLTINT[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	short	value,
		int	offset
	)

Puts the input data value into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

value	is the single value which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData ( DBLDBLDBL[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	DBLDBLDBL[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	short[]	values,
		int	offset
	)

Puts the input data value array into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

values	is the values array which should be copied into the underlying byte stream and referenced data object at the given offset.
offset	is the position offset within the targeted array

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

Exceptions:

InputDataLockedException if a link using this TDataType as input is bound to another link and an attempt to alter the input data set (which is part of the contract cached at the target server) is made.

int de.desy.tine.dataUtils.TDataType.putData ( long data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	long[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( boolean data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is data primitive whose value is copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( boolean[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	byte[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData	(	boolean[]	data,
		int	length,
		int	offset
	)

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.
length	is the number of elements from the give data object to copy
offset	is the starting offset within the array to copy

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( int[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

int de.desy.tine.dataUtils.TDataType.putData ( FLTINT[] data )

Puts the current canonical data set into the underlying data byte stream Puts the input data set into the underlying byte stream, properly swapped and aligned.

It replaces the contents of the original, referenced data array with that of the data object given.

Parameters:

data	is the data object whose contents should be copied into the underlying byte stream and referenced data object.

Note:: If this TDataType object is used as input data in persistent links, then the data object might well be 'locked' meaning that the underlying data will NOT be changed, as this would constitute a change in contract.

Returns:: 0 upon success or a tine error code

String de.desy.tine.dataUtils.TDataType.toString ( )

Outputs the returned data as a String.

This method is useful for displaying the unbound data when the data type is unknown at link time.

static TDataType de.desy.tine.dataUtils.TDataType.toTDataType	(	String	text,
		String	fmtstring
	)		`[static]`

parse input string into a TDataType

Parameters:

text	is the text string which is to be parsed into data
fmtstring	is the TINE format code (in string representation) defining the parsing rules

Returns:: a valid TDataType object or null if the input text cannot be parsed into a TDataType

static TDataType de.desy.tine.dataUtils.TDataType.toTDataType	(	String	text,
		short	fmtcode
	)		`[static]`

parse input string into a TDataType

Parameters:

text	is the text string which is to be parsed into data
fmtcode	is the TINE format code defining the parsing rules

Returns:: a valid TDataType object or null if the input text cannot be parsed into a TDataType

static int de.desy.tine.dataUtils.TDataType.UnsignedInt ( long lval ) [static]

Forms an 'equivalent' unsigned integer for transmission.

Parameters:

lval	a java long value (signed) to be encoded as an unsigned integer

Returns:: the encoded unsigned integer

static long de.desy.tine.dataUtils.TDataType.UnsignedInt ( int ival ) [static]

Converts a value transmitted as an 'unsigned' integer to a java signed long.

Parameters:

ival	an encoded unsigned integer value

Returns:: the corresponding java signed long

static short de.desy.tine.dataUtils.TDataType.UnsignedShort ( int ival ) [static]

Forms an 'equivalent' unsigned short for transmission.

Parameters:

ival	a java integer value (signed) to be encoded as an unsigned short

Returns:: the encoded unsigned short

static int de.desy.tine.dataUtils.TDataType.UnsignedShort ( short sval ) [static]

Converts a value transmitted as an 'unsigned' short to a java signed integer.

Parameters:

sval	an encoded unsigned short value

Returns:: the corresponding java signed integer

The documentation for this class was generated from the following file:

TDataType.java

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation