compact1, compact2, compact3

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's индексируют одним, и возвращается, символ в новом индексируют.
char	previous() Постепенно уменьшается iterator's индексируют одним, и возвращается, символ в новом индексируют.
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's индексируют одним, и возвращается, символ в новом индексируют. Если получающиеся индексируют, больше или равен getEndIndex (), ток индексируют, сбрасывается к getEndIndex (), и значение СДЕЛАННЫХ возвращается.

Возвраты:

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

предыдущий

char previous()

Постепенно уменьшается iterator's индексируют одним, и возвращается, символ в новом индексируют. Если ток индексирует, 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

Возвраты:

Копия этого