oracle.adfnmc.java.lang
Interface Appendable

public interface Appendable

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.

Method Summary

Appendable	append(char c) Append the given character.
Appendable	append(java.lang.String csq) Append the given CharSequence.
Appendable	append(java.lang.String csq, int start, int end) Append part of the given CharSequence.

Method Detail

append

Appendable append(char c)
                  throws java.io.IOException

Append the given character.

Parameters:

c - the character to append

Returns:

this Appendable

Throws:

java.io.IOException - if some I/O operation fails

append

Appendable append(java.lang.String csq)
                  throws java.io.IOException

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

Returns:

this Appendable

Throws:

java.io.IOException - if some I/O operation fails

append

Appendable append(java.lang.String csq,
                  int start,
                  int end)
                  throws java.io.IOException

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

start - the index to specify the start position of CharSequence to be append, must be non-negative, and not larger than the end

end - the index to specify the end position of CharSequence to be append, must be non-negative, and not larger than the size of csq

Returns:

this Appendable

Throws:

java.io.IOException - if some I/O operation fails

java.lang.IndexOutOfBoundsException - if the start or end is illegal