java.util.Formatter.
The characters to be appended should be valid Unicode characters as described in Unicode Character Representation. Note that supplementary characters may be composed of multiple 16-bit char values.
Appendables are not necessarily safe for multithreaded access. Thread safety is the responsibility of classes that extend and implement this interface.
Since this interface may be implemented by existing classes with different styles of error handling there is no guarantee that errors will be propagated to the invoker.
Depending on which class implements the character sequence
csq, the entire sequence may not be appended. For
instance, if csq is a then
the subsequence to append is defined by the buffer's position and limit.
java.nio.CharBuffer
csq
The character sequence to append. If csq is
null, then the four characters "null" are
appended to this Appendable.java.io.IOException
If an I/O error occursAn invocation of this method of the form out.append(csq, start, end) when csq is not null, behaves in exactly the same way as the invocation
out.append(csq.subSequence(start, end))
csq
The character sequence from which a subsequence will be
appended. If csq is null, then characters
will be appended as if csq contained the four
characters "null".start
The index of the first character in the subsequenceend
The index of the character following the last character in the
subsequenceIndexOutOfBoundsException
If start or end are negative, start
is greater than end, or end is greater than
csq.length()java.io.IOException
If an I/O error occursc
The character to appendjava.io.IOException
If an I/O error occurs