java.text

Интерфейсный CharacterIterator

Все Суперинтерфейсы:

Cloneable

Все Известные Подынтерфейсы:

AttributedCharacterIterator

Все Известные Классы с реализацией:

Сегмент, StringCharacterIterator

public interface CharacterIterator
extends Cloneable

Этот интерфейс определяет протокол для двунаправленной итерации по тексту. iterator выполняет итерации по ограниченной последовательности символов. Символы индексируются со значениями, начинающимися со значения, возвращенного getBeginIndex () и продолжающимися через значение, возвращенное getEndIndex ()-1.

Iterators поддерживают текущий символьный индекс, допустимый диапазон которого от getBeginIndex () к getEndIndex (); значение getEndIndex () включается, чтобы позволить обрабатывать текстовых диапазонов нулевых длиной и по историческим причинам. Текущий индекс может быть получен, вызывая getIndex () и установлен непосредственно, вызывая setIndex (), сначала (), и последний ().

Предыдущие методы () и затем () используются для итерации. Они возвращаются СДЕЛАННЫЙ, если они переместились бы вне диапазона от getBeginIndex () к getEndIndex ()-1, сигнализируя, что iterator достиг конца последовательности. СДЕЛАННЫЙ также возвращается другими методами, чтобы указать, что текущий индекс вне этого диапазона.

Примеры:

Пересеките текст от начала до конца

 public void traverseForward(CharacterIterator iter) {
     for(char c = iter.first(); c != CharacterIterator.DONE; c = iter.next()) {
         processChar(c);
     }
 }
 

Пересеките текст назад от конца, чтобы запустить

 public void traverseBackward(CharacterIterator iter) {
     for(char c = iter.last(); c != CharacterIterator.DONE; c = iter.previous()) {
         processChar(c);
     }
 }
 

Пересеките и вперед и назад от данной позиции в тексте. Звонки notBoundary () в этом примере представляют некоторые дополнительные критерии остановки.

 public void traverseOut(CharacterIterator iter, int pos) {
     for (char c = iter.setIndex(pos);
              c != CharacterIterator.DONE && notBoundary(c);
              c = iter.next()) {
     }
     int end = iter.getIndex();
     for (char c = iter.setIndex(pos);
             c != CharacterIterator.DONE && notBoundary(c);
             c = iter.previous()) {
     }
     int start = iter.getIndex();
     processSection(start, end);
 }
 

См. Также:

StringCharacterIterator, AttributedCharacterIterator

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static char	СДЕЛАННЫЙ Постоянный, который возвращается, когда iterator достиг или конца или начало текста.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Объект	clone() Создайте копию этого iterator
char	current() Получает символ в текущей позиции (как возвращено getIndex ()).
char	first() Устанавливает позицию в getBeginIndex () и возвращает символ в той позиции.
int	getBeginIndex() Возвращает индекс запуска текста.
int	getEndIndex() Возвращает индекс конца текста.
int	getIndex() Возвращает текущий индекс.
char	last() Устанавливает позицию в getEndIndex ()-1 (getEndIndex (), если текст пуст), и возвращает символ в той позиции.
char	next() Постепенно увеличивает индекс iterator одним и возвращает символ по новому индексу.
char	previous() Постепенно уменьшает индекс iterator одним и возвращает символ по новому индексу.
char	setIndex(int position) Устанавливает позицию в указанную позицию в тексте и возвратах тот символ.

Полевая Деталь

СДЕЛАННЫЙ

static final char DONE

Постоянный, который возвращается, когда iterator достиг или конца или начало текста. Значение '\\uFFFF', "не символьное" значение, которое не должно произойти ни в какой допустимой строке Unicode.

См. Также:

Постоянные Значения полей

Деталь метода

сначала

char first()

Устанавливает позицию в getBeginIndex () и возвращает символ в той позиции.

Возвраты:

первый символ в тексте, или СДЕЛАННЫЙ, если текст пуст

См. Также:

getBeginIndex()

последний

char last()

Устанавливает позицию в getEndIndex ()-1 (getEndIndex (), если текст пуст), и возвращает символ в той позиции.

Возвраты:

последний знак в тексте, или СДЕЛАННЫЙ, если текст пуст

См. Также:

getEndIndex()

ток

char current()

Получает символ в текущей позиции (как возвращено getIndex ()).

Возвраты:

символ в текущей позиции или СДЕЛАННЫЙ, если текущая позиция от конца текста.

См. Также:

getIndex()

затем

char next()

Постепенно увеличивает индекс iterator одним и возвращает символ по новому индексу. Если получающийся индекс больше или равен getEndIndex (), текущий индекс сбрасывается к getEndIndex (), и значение СДЕЛАННЫХ возвращается.

Возвраты:

символ в новой позиции или СДЕЛАННЫЙ, если новая позиция от конца текстового диапазона.

предыдущий

char previous()

Постепенно уменьшает индекс iterator одним и возвращает символ по новому индексу. Если текущий индекс является getBeginIndex (), индекс остается в getBeginIndex (), и значение СДЕЛАННЫХ возвращается.

Возвраты:

символ в новой позиции или СДЕЛАННЫЙ, если текущая позиция равна getBeginIndex ().

setIndex

char setIndex(int position)

Устанавливает позицию в указанную позицию в тексте и возвратах тот символ.

Параметры:

position - позиция в пределах текста. Допустимые значения колеблются от getBeginIndex () к getEndIndex (). IllegalArgumentException бросается, если недопустимое значение предоставляется.

Возвраты:

символ в указанной позиции или СДЕЛАННЫЙ, если указанная позиция равна getEndIndex ()

getBeginIndex

int getBeginIndex()

Возвращает индекс запуска текста.

Возвраты:

индекс, по которому начинается текст.

getEndIndex

int getEndIndex()

Возвращает индекс конца текста. Этот индекс является индексом первого символа после конца текста.

Возвраты:

индекс после последнего знака в тексте

getIndex

int getIndex()

Возвращает текущий индекс.

Возвраты:

текущий индекс.

клон

Object clone()

Создайте копию этого iterator

Возвраты:

Копия этого