Класс StringCharacterIterator

java.lang.Object

java.text.StringCharacterIterator

Все реализованные интерфейсы:: Cloneable, CharacterIterator

public final class StringCharacterIterator extends Object implements CharacterIterator

StringCharacterIterator реализует протокол CharacterIterator для String. Класс StringCharacterIterator итерируется по всей String.

С:

1.1

См. также:

Краткое описание полей

Поля, объявленные в интерфейсе java.text.CharacterIterator

DONE

Краткое описание конструкторов

Конструктор	Описание
`StringCharacterIterator(String text)`	Создаёт итератор с начальным индексом 0.
`StringCharacterIterator(String text, int pos)`	Создаёт итератор с указанным начальным индексом.
`StringCharacterIterator(String text, int begin, int end, int pos)`	Создаёт итератор по заданному диапазону заданной строки, с индексом, установленным в указанной позиции.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создаёт копию этого итератора.
`char`	`current()`	Реализует CharacterIterator.current() для String.
`boolean`	`equals(Object obj)`	Сравнивает равенство двух объектов StringCharacterIterator.
`char`	`first()`	Реализует CharacterIterator.first() для String.
`int`	`getBeginIndex()`	Реализует CharacterIterator.getBeginIndex() для String.
`int`	`getEndIndex()`	Реализует CharacterIterator.getEndIndex() для String.
`int`	`getIndex()`	Реализует CharacterIterator.getIndex() для String.
`int`	`hashCode()`	Вычисляет хэш-код для этого итератора.
`char`	`last()`	Реализует CharacterIterator.last() для String.
`char`	`next()`	Реализует CharacterIterator.next() для String.
`char`	`previous()`	Реализует CharacterIterator.previous() для String.
`char`	`setIndex(int p)`	Реализует CharacterIterator.setIndex() для String.
`void`	`setText(String text)`	Сбрасывает этот итератор для указания на новую строку.

Методы, объявленные в классе java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

StringCharacterIterator

public StringCharacterIterator(String text)

Создаёт итератор со значением начального индекса 0.

Параметры:: text - String для итерации

StringCharacterIterator

public StringCharacterIterator(String text, int pos)

Создаёт итератор с заданным начальным индексом.

Параметры:: text - Строка для итерации; pos - Начальная позиция итератора

StringCharacterIterator

public StringCharacterIterator(String text, int begin, int end, int pos)

Создаёт итератор над заданным диапазоном данной строки, с установленным индексом в указанной позиции.

Параметры:: text - Строка для итерации; begin - Индекс первого символа; end - Индекс символа, следующего за последним символом; pos - Начальная позиция итератора

Подробное описание методов

setText

public void setText(String text)

Сбрасывает этот итератор, чтобы он указывал на новую строку. Этот метод с доступом из пакета используется другими классами java.text, чтобы избежать выделения новых объектов StringCharacterIterator каждый раз, когда вызывается их метод setText.

Параметры:: text - Строка для итерации
С:: 1.2

first

public char first()

Реализует CharacterIterator.first() для String.

Задано:

first в интерфейсе CharacterIterator

Возвращает:

первый символ в тексте или DONE, если текст пуст

См. также:

last

public char last()

Реализует CharacterIterator.last() для String.

Задано:

last в интерфейсе CharacterIterator

Возвращает:

последний символ в тексте или DONE, если текст пуст

См. также:

setIndex

public char setIndex(int p)

Реализует CharacterIterator.setIndex() для String.

Задано:

setIndex в интерфейсе CharacterIterator

Параметры:

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

Возвращает:

символ в указанной позиции или DONE, если указанная позиция равна getEndIndex()

См. также:

current

public char current()

Реализует CharacterIterator.current() для String.

Задано:

current в интерфейсе CharacterIterator

Возвращает:

символ в текущей позиции или DONE, если текущая позиция выходит за пределы текста.

См. также:

public char next()

Реализует CharacterIterator.next() для String.

Задано:

next в интерфейсе CharacterIterator

Возвращает:

символ в новой позиции или DONE, если новая позиция выходит за пределы диапазона текста.

См. также:

public char previous()

Реализует CharacterIterator.previous() для String.

Задано:

previous в интерфейсе CharacterIterator

Возвращает:

символ в новой позиции или DONE, если текущая позиция равна getBeginIndex().

См. также:

getBeginIndex

public int getBeginIndex()

Реализует CharacterIterator.getBeginIndex() для String.

Задано:

getBeginIndex в интерфейсе CharacterIterator

Возвращает:

индекс начала текста.

См. также:

getEndIndex

public int getEndIndex()

Реализует CharacterIterator.getEndIndex() для String.

Задано:

getEndIndex в интерфейсе CharacterIterator

Возвращает:

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

См. также:

getIndex

public int getIndex()

Реализует CharacterIterator.getIndex() для String.

Задано:

getIndex в интерфейсе CharacterIterator

Возвращает:

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

См. также:

equals

public boolean equals(Object obj)

Сравнивает равенство двух объектов StringCharacterIterator.

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

equals в классе Object

Параметры:

obj - объект StringCharacterIterator для сравнения.

Возвращает:

true, если данный obj такой же, как этот объект StringCharacterIterator; иначе false.

См. также:

hashCode

public int hashCode()

Вычисляет хэш-код для этого итератора.

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

hashCode в классе Object

Возвращает:

Хэш-код

См. также:

clone

public Object clone()

Создаёт копию этого итератора.

Задано:

clone в интерфейсе CharacterIterator

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

clone в классе Object

Возвращает:

Копию этого

См. также:

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/text/StringCharacterIterator.html