|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface CharSequence
General functions on a sequence of chars. This interface is implemented
by String
, StringBuffer
and
CharBuffer
to give a uniform way to get chars at a certain
index, the number of characters in the sequence and a subrange of the
chars. Indexes start at 0 and the last index is length()-1
.
Even when classes implement this interface they are not always
exchangeble because they might implement their compare, equals or hash
function differently. This means that in general one should not use a
CharSequence
as keys in collections since two sequences
with the same chars at the same indexes with the same length might not
have the same hash code, be equal or be comparable since the are
represented by different classes.
Method Summary | |
---|---|
char |
charAt(int i)
Returns the character at the given index. |
int |
length()
Returns the length of the sequence. |
CharSequence |
subSequence(int begin,
int end)
Returns a new CharSequence of the indicated range. |
String |
toString()
Returns the complete CharSequence as a String . |
Method Detail |
---|
char charAt(int i)
i
- the index to retrieve from
IndexOutOfBoundsException
- if i < 0 || i >= length() - 1int length()
CharSequence subSequence(int begin, int end)
CharSequence
of the indicated range.
begin
- the start index (inclusive)end
- the end index (exclusive)
IndexOutOfBoundsException
- if begin > end || begin < 0 ||
end > length()String toString()
CharSequence
as a String
.
Classes that implement this interface should return a String
which contains only the characters in the sequence in the correct order.
toString
in class Object
Object.getClass()
,
Object.hashCode()
,
Class.getName()
,
Integer.toHexString(int)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |