| java.lang.Appendable
All known Subclasses: java.nio.CharBuffer, java.io.Writer, java.io.PrintStream,
| Appendable | | public interface Appendable (Code) | | Appendable is an object used to append character or character sequence. Any
class implements this interface can receive data formatted by
Formatter. The appended character or character sequence
should be valid according to the rules described
Unicode Character Representation.
Appendable itself does not guarantee thread safety. This responsibility is up
to the implementing class.
The implementing class can choose different exception handling mechanism. It
can choose to throw exceptions other than IOException but which must be
compatible with IOException, or does not throw any exceptions at all and use
error code instead. All in all, the implementing class does not guarantee to
propagate the exception declared by this interface.
|
| append | | Appendable append(char c) throws IOException(Code) | | Append the given character.
Parameters:
c - the character to append this Appendable
throws:
IOException - if some I/O operation fails |
| append | | Appendable append(CharSequence csq) throws IOException(Code) | | Append the given CharSequence.
The behaviour of this method depends on the implementation class of
Appendable.
If the give CharSequence is null, the sequence is treated
as String "null".
Parameters:
csq - the CharSequence to be append this Appendable
throws:
IOException - if some I/O operation fails |
| append | | Appendable append(CharSequence csq, int start, int end) throws IOException(Code) | | Append part of the given CharSequence.
If the given CharSequence is not null, this method behaves
same as the following statement:
out.append(csq.subSequence(start, end))
If the give CharSequence is null, the sequence is treated
as String "null".
Parameters:
csq - the CharSequence to be append
Parameters:
start - the index to specify the start position ofCharSequence to be append, must benon-negative, and not larger than the end
Parameters:
end - the index to specify the end position ofCharSequence to be append, must benon-negative, and not larger than the size of csq this Appendable
throws:
IOException - if some I/O operation fails
throws:
IndexOutOfBoundsException - if the start or end is illegal |
|
|