Интерфейс CharSequence

public interface CharSequence

A CharSequence представляет собой читаемую последовательность char значений. Этот интерфейс предоставляет унифицированный, только для чтения доступ к различным типам последовательностей char. Значение char представляет собой символ в основной многоязычной плоскости (BMP) или суррогат. Подробности см. в Представление символов Юникода.

Этот интерфейс не уточняет общие соглашения методов equals и hashCode. Поэтому результат сравнения двух объектов, реализующих CharSequence, в общем случае не определён. Каждый объект может быть реализован другим классом, и нет гарантии, что каждый класс сможет проверять свои экземпляры на равенство с экземплярами другого класса. Поэтому не следует использовать произвольные экземпляры CharSequence в качестве элементов множества или ключей в карте.

Методы

length

int length()

Возвращает длину этой последовательности символов. Длина — это количество 16-битных char в последовательности.

Возвращает:

количество char в этой последовательности

charAt

char charAt(int index)

Параметры:

index - индекс значения char , которое должно быть возвращено

Возвращает:

указанное значение char

Исключение:

IndexOutOfBoundsException - если аргумент index отрицательный или не меньше length()

subSequence

CharSequence subSequence(int start,
                         int end)

Возвращает CharSequence , которая является подпоследовательностью этой последовательности. Подпоследовательность начинается со значения char по указанному индексу и заканчивается значением char по индексу end - 1. Длина (в char ) возвращаемой последовательности равна end - start, поэтому если start == end, возвращается пустая последовательность.

Параметры:

start - начальный индекс, включительно

end - конечный индекс, исключая

Возвращает:

указанная подпоследовательность

Исключение:

IndexOutOfBoundsException - если start или end отрицательные, если end больше, чем length(), или если start больше, чем end

toString

String toString()

Возвращает строку, содержащую символы в этой последовательности в том же порядке, что и в этой последовательности. Длина строки будет равна длине этой последовательности.

Переопределяет:

toString в классе Object

Возвращает:

строка, состоящая ровно из этой последовательности символов

chars

default IntStream chars()

Возвращает:

IntStream значений char из этой последовательности

С тех пор как:

1.8

codePoints

default IntStream codePoints()

Возвращает:

IntStream точек кода Юникода из этой последовательности

С тех пор как:

1.8