Since: API Level 1
public interface

Appendable

java.lang.Appendable
Known Indirect Subclasses

Class Overview

Declares methods to append characters or character sequences. Any class that implements this interface can receive data formatted by a Formatter. The appended character or character sequence should be valid according to the rules described in Unicode Character Representation.

Appendable itself does not guarantee thread safety. This responsibility is up to the implementing class.

Implementing classes can choose different exception handling mechanism. They can choose to throw exceptions other than IOException or they do not throw any exceptions at all and use error codes instead.

Summary

Public Methods
abstract Appendable append(CharSequence csq)
Appends the character sequence csq.
abstract Appendable append(CharSequence csq, int start, int end)
Appends a subsequence of csq.
abstract Appendable append(char c)
Appends the specified character.

Public Methods

public abstract Appendable append (CharSequence csq)

Since: API Level 1

Appends the character sequence csq. Implementation classes may not append the whole sequence, for example if the target is a buffer with limited size.

If csq is null, the characters "null" are appended.

Parameters
csq the character sequence to append.
Returns
  • this Appendable.
Throws
IOException if an I/O error occurs.

public abstract Appendable append (CharSequence csq, int start, int end)

Since: API Level 1

Appends a subsequence of csq.

If csq is not null then calling this method is equivalent to calling append(csq.subSequence(start, end)).

If csq is null, the characters "null" are appended.

Parameters
csq the character sequence to append.
start the first index of the subsequence of csq that is appended.
end the last index of the subsequence of csq that is appended.
Returns
  • this Appendable.
Throws
IndexOutOfBoundsException if start < 0, end < 0, start > end or end is greater than the length of csq.
IOException if an I/O error occurs.

public abstract Appendable append (char c)

Since: API Level 1

Appends the specified character.

Parameters
c the character to append.
Returns
  • this Appendable.
Throws
IOException if an I/O error occurs.