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
.
Returns:
The number of bytes written out.
Parameters:
- str - a string to be written.
- out - destination to write to
Throws:
- IOException - if an I/O error occurs.