File Doc Category Size Date Package
Appendable.java API Doc Android 1.5 API 3543 Wed May 06 22:41:04 BST 2009 java.lang

Appendable

public interface Appendable

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

{@code 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 {@code IOException} or they do not throw any exceptions at all and use error codes instead.

since: Android 1.0

Fields Summary
Constructors Summary
Methods Summary
public java.lang.Appendable append(char c)
Appends the specified character.
param
c the character to append.
return
this {@code Appendable}.
throws
IOException if an I/O error occurs.
since
Android 1.0
public java.lang.Appendable append(java.lang.CharSequence csq)
Appends the character sequence {@code csq}. Implementation classes may not append the whole sequence, for example if the target is a buffer with limited size.
If {@code csq} is {@code null}, the characters "null" are appended.
param
csq the character sequence to append.
return
this {@code Appendable}.
throws
IOException if an I/O error occurs.
since
Android 1.0
public java.lang.Appendable append(java.lang.CharSequence csq, int start, int end)
Appends a subsequence of {@code csq}.
If {@code csq} is not {@code null} then calling this method is equivalent to calling {@code append(csq.subSequence(start, end))}.
If {@code csq} is {@code null}, the characters "null" are appended.
param
csq the character sequence to append.
param
start the first index of the subsequence of {@code csq} that is appended.
param
end the last index of the subsequence of {@code csq} that is appended.
return
this {@code Appendable}.
throws
IndexOutOfBoundsException if {@code start < 0}, {@code end < 0}, {@code start > end} or {@code end} is greater than the length of {@code csq}.
throws
IOException if an I/O error occurs.
since
Android 1.0