Класс Segment

public class Segment
extends Object
implements Cloneable, CharacterIterator, CharSequence

Отрезок массива символов, представляющий фрагмент текста. Он должен рассматриваться как неизменяемый, даже если массив напрямую доступен. Это обеспечивает быстрый доступ к фрагментам текста без накладных расходов на копирование символов. Это фактически неохраняемая строка.

Segment реализует интерфейс java.text.CharacterIterator, чтобы поддерживать использование с поддержкой i18n без копирования текста в строку.

Поля

array

public char[] array

Это массив, содержащий интересующий текст. Этот массив никогда не должен изменяться; он доступен только для повышения эффективности.

offset

public int offset

Это смещение в массиве, с которого начинается нужный текст.

count

public int count

Это количество элементов массива, составляющих интересующий текст.

Конструкторы

Segment

public Segment()

Создает новый сегмент.

Segment

public Segment(char[] array,
               int offset,
               int count)

Создает новый сегмент, ссылающийся на существующий массив.

Параметры:

array - массив, на который следует сослаться

offset - смещение в массиве

count - количество символов

Методы

setPartialReturn

public void setPartialReturn(boolean p)

Флаг, указывающий, что частичные возвраты допустимы. Если флаг имеет значение true, реализация метода интерфейса Document.getText(position,length,Segment) должна возвращать как можно больше текста без создания копии. Значение флага по умолчанию — false, что приведет к тому, что Document.getText(position,length,Segment) будет вести себя так же, как и всегда, что может или не может привести к копированию текста в зависимости от запроса.

Параметры:

p - указывающее, допустимы ли частичные возвраты.

С:

1.4

isPartialReturn

public boolean isPartialReturn()

Флаг, указывающий, что частичные возвраты допустимы.

Возвращает:

указывающее, допустимы ли частичные возвраты.

С:

1.4

toString

public String toString()

Преобразует сегмент в строку.

Определено в:

toString в интерфейсе CharSequence

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

toString в классе Object

Возвращает:

строку

first

public char first()

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

Определено в:

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

Возвращает:

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

С:

1.3

См. также:

getBeginIndex()

last

public char last()

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

Определено в:

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

Возвращает:

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

С:

1.3

См. также:

getEndIndex()

current

public char current()

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

Определено в:

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

Возвращает:

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

С:

1.3

См. также:

getIndex()

next

public char next()

Увеличивает индекс итератора на единицу и возвращает символ в новой позиции. Если полученный индекс больше или равен getEndIndex(), текущий индекс сбрасывается до getEndIndex(), и возвращается значение DONE.

Определено в:

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

Возвращает:

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

С:

1.3

previous

public char previous()

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

Определено в:

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

Возвращает:

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

С:

1.3

setIndex

public char setIndex(int position)

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

Определено в:

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

Параметры:

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

Возвращает:

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

С:

1.3

getBeginIndex

public int getBeginIndex()

Возвращает начальный индекс текста.

Определено в:

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

Возвращает:

индекс, с которого начинается текст.

С:

1.3

getEndIndex

public int getEndIndex()

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

Определено в:

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

Возвращает:

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

С:

1.3

getIndex

public int getIndex()

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

Определено в:

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

Возвращает:

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

С:

1.3

charAt

public char charAt(int index)

Определено в:

charAt в интерфейсе CharSequence

Параметры:

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

Возвращает:

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

С:

1.6

length

public int length()

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

Определено в:

length в интерфейсе CharSequence

Возвращает:

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

С:

1.6

subSequence

public CharSequence subSequence(int start,
                                int end)

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

Определено в:

subSequence в интерфейсе CharSequence

Параметры:

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

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

Возвращает:

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

С:

1.6

clone

public Object clone()

Создает поверхностную копию.

Определено в:

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

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

clone в классе Object

Возвращает:

копию

См. также:

Cloneable