org.scijava.io.handle

Class DataHandles

java.lang.Object

org.scijava.io.handle.DataHandles

public final class DataHandles
extends Object

Utility methods for working with DataHandles.

Author:

Curtis Rueden

Method Summary

Modifier and Type	Method and Description
static int	writeUTF(String str, DataOutput out) Writes a string to the specified DataOutput using modified UTF-8 encoding in a machine-independent manner.

Methods inherited from class java.lang.Object

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

Method Detail

writeUTF

public static int writeUTF(String str,
                           DataOutput out)
                    throws IOException

Writes a string to the specified DataOutput using modified UTF-8 encoding in a machine-independent manner.

First, two bytes are written to out as if by the writeShort method giving the number of bytes to follow. This value is the number of bytes actually written out, not the length of the string. Following the length, each character of the string is output, in sequence, using the modified UTF-8 encoding for the character. If no exception is thrown, the counter written is incremented by the total number of bytes written to the output stream. This will be at least two plus the length of str, and at most two plus thrice the length of str.

Parameters:

str - a string to be written.

out - destination to write to

Returns:

The number of bytes written out.

Throws:

IOException - if an I/O error occurs.