Список (Платформа Java SE 7)

Введите Параметры:
E - тип элементов в этом списке

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

Набор <E>, Повторяемый <E>

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

AbstractList, AbstractSequentialList, ArrayList, AttributeList, CopyOnWriteArrayList, LinkedList, RoleList, RoleUnresolvedList, Стек, Вектор
```
public interface List<E>
extends Collection<E>
```
Упорядоченный набор (также известный как последовательность). Пользователь этого интерфейса имеет точный контроль, где в списке каждый элемент вставляется. Пользователь может получить доступ к элементам их целочисленным индексом (позиция в списке), и искать элементы в списке.
В отличие от наборов, списки обычно позволяют двойные элементы. Более формально списки обычно позволяют пар элементов e1 и e2 так, что e1.equals(e2), и они обычно позволяют многократные нулевые элементы, если они позволяют нулевые элементы вообще. Весьма возможно, что кто-то мог бы хотеть реализовать список, который запрещает копии, бросая исключения на этапе выполнения, когда пользователь попытается вставить их, но мы ожидаем, что это использование будет редко.
Интерфейс List помещает дополнительные соглашения, вне определенных в интерфейсе Collection, по контрактам iterator, add, remove, equals, и методов hashCode. Объявления для других наследованных методов также включаются здесь для удобства.
Интерфейс List обеспечивает четыре метода для позиционного (индексированного) доступа, чтобы перечислить элементы. Списки (как массивы Java) являются базируемым нулем. Отметьте, что эти операции могут выполниться вовремя пропорциональный индексному значению для некоторых реализаций (класс LinkedList, например). Таким образом итерация по элементам в списке обычно предпочтительна для индексации через это, если вызывающая сторона не знает реализацию.
Интерфейс List обеспечивает специальный iterator, названный ListIterator, который позволяет вставку элемента и замену, и двунаправленный доступ в дополнение к нормальному функционированию, которое обеспечивает интерфейс Iterator. Метод обеспечивается, чтобы получить список iterator, который запускается в указанной позиции в списке.
Интерфейс List обеспечивает два метода, чтобы искать указанный объект. С точки зрения производительности эти методы должны использоваться с осторожностью. Во многих реализациях они выполнят дорогостоящие линейные поиски.
Интерфейс List обеспечивает два метода, чтобы эффективно вставить и удалить многократные элементы в произвольной точке в списке.
Отметьте: В то время как допустимо для списков содержать себя как элементы, экстремальное предостережение советуется: методы equals И hashCode больше не четко определены в таком списке.
У некоторых реализаций списка есть ограничения на элементы, которые они могут содержать. Например, некоторые реализации запрещают нулевые элементы, и у некоторых есть ограничения на типы их элементов. Попытка добавить неподходящий элемент выдает исключение непроверенное, обычно NullPointerException или ClassCastException. Попытка запросить присутствие неподходящего элемента может выдать исключение, или это может просто возвратить false; некоторые реализации покажут прежнее поведение, и некоторые покажут последнего. Более широко попытка работы на неподходящем элементе, завершение которого не привело бы к вставке неподходящего элемента в список, может выдать исключение, или это может успешно выполниться в опции реализации. Такие исключения отмечаются как "дополнительные" в спецификации для этого интерфейса.
Этот интерфейс является элементом Платформы Наборов Java.

С тех пор:

1.2

См. Также:
Collection, Set, ArrayList, LinkedList, Vector, Arrays.asList(Object[]), Collections.nCopies(int, Object), Collections.EMPTY_LIST, AbstractList, AbstractSequentialList

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

Методы
Модификатор и Тип	Метод и Описание
`boolean`	`add(E e)` Добавляет указанный элемент до конца этого списка (дополнительная работа).
`void`	`add(int index, E element)` Вставляет указанный элемент в указанной позиции в этом списке (дополнительная работа).
`boolean`	`addAll(Collection<? extends E> c)` Добавляет все элементы в указанном наборе до конца этого списка, в порядке, что они возвращаются iterator указанного набора (дополнительная работа).
`boolean`	`addAll(int index, Collection<? extends E> c)` Вставляет все элементы в указанном наборе в этот список в указанной позиции (дополнительная работа).
`void`	`clear()` Удаляет все элементы от этого списка (дополнительная работа).
`boolean`	`contains(Object o)` `true` возвратов, если этот список содержит указанный элемент.
`boolean`	`containsAll(Collection<?> c)` `true` возвратов, если этот список содержит все элементы указанного набора.
`boolean`	`equals(Object o)` Сравнивает указанный объект с этим списком для равенства.
`E`	`get(int index)` Возвращает элемент в указанной позиции в этом списке.
`int`	`hashCode()` Возвращает значение хэш-кода для этого списка.
`int`	`indexOf(Object o)` Возвращает индекс первого возникновения указанного элемента в этом списке, или-1, если этот список не содержит элемент.
`boolean`	`isEmpty()` `true` возвратов, если этот список не содержит элементов.
`Iterator<E>`	`iterator()` Возвращает iterator по элементам в этом списке в надлежащей последовательности.
`int`	`lastIndexOf(Object o)` Возвращает индекс последнего вхождения указанного элемента в этом списке, или-1, если этот список не содержит элемент.
`ListIterator<E>`	`listIterator()` Возвращает список iterator по элементам в этом списке (в надлежащей последовательности).
`ListIterator<E>`	`listIterator(int index)` Возвращает список iterator по элементам в этом списке (в надлежащей последовательности), запускаясь в указанной позиции в списке.
`E`	`remove(int index)` Удаляет элемент в указанной позиции в этом списке (дополнительная работа).
`boolean`	`remove(Object o)` Удаляет первое возникновение указанного элемента от этого списка, если это присутствует (дополнительная работа).
`boolean`	`removeAll(Collection<?> c)` Удаляет из этого списка все его элементы, которые содержатся в указанном наборе (дополнительная работа).
`boolean`	`retainAll(Collection<?> c)` Сохраняет только элементы в этом списке, которые содержатся в указанном наборе (дополнительная работа).
`E`	`set(int index, E element)` Заменяет элемент в указанной позиции в этом списке с указанным элементом (дополнительная работа).
`int`	`size()` Возвращает число элементов в этом списке.
`List<E>`	`subList(int fromIndex, int toIndex)` Возвращает представление части этого списка между указанным `fromIndex`, включительно, и `toIndex`, монопольным.
`Объект[]`	`toArray()` Возвращает массив, содержащий все элементы в этом списке в надлежащей последовательности (от сначала, чтобы продлиться элемент).
`<T> T[]`	`toArray(T[] a)` Возвращает массив, содержащий все элементы в этом списке в надлежащей последовательности (от сначала, чтобы продлиться элемент); тип времени выполнения возвращенного массива является типом указанного массива.

- Деталь метода
  - размер
```
int size()
```
    Возвращает число элементов в этом списке. Если этот список содержит больше чем элементы Integer.MAX_VALUE, Integer.MAX_VALUE возвратов.
    
    Определенный:
    
    size в интерфейсе Collection<E>
    
    Возвраты:
    число элементов в этом списке
  - isEmpty
```
boolean isEmpty()
```
    true возвратов, если этот список не содержит элементов.
    
    Определенный:
    
    isEmpty в интерфейсе Collection<E>
    
    Возвраты:
    true, если этот список не содержит элементов
  - содержит
```
boolean contains(Object o)
```
    true возвратов, если этот список содержит указанный элемент. Более формально, возвраты true, если и только если этот список содержит по крайней мере один элемент e так, что (o==null ? e==null : o.equals(e)).
    
    Определенный:
    
    contains в интерфейсе Collection<E>
    
    Параметры:
    o - элемент, присутствие которого в этом списке должно быть протестировано
    
    Возвраты:
    true, если этот список содержит указанный элемент
    
    Броски:
    
    ClassCastException - если тип указанного элемента является несовместимым с этим (дополнительным) списком
    
    NullPointerException - если указанный элемент является нулем, и этот список не разрешает нулевые (дополнительные) элементы
  - iterator
```
Iterator<E> iterator()
```
    Возвращает iterator по элементам в этом списке в надлежащей последовательности.
    
    Определенный:
    
    iterator в интерфейсе Collection<E>
    
    Определенный:
    
    iterator в интерфейсе Iterable<E>
    
    Возвраты:
    iterator по элементам в этом списке в надлежащей последовательности
  - toArray
```
Object[] toArray()
```
    Возвращает массив, содержащий все элементы в этом списке в надлежащей последовательности (от сначала, чтобы продлиться элемент).
    Возвращенный массив будет "безопасен" в этом, никакие ссылки на него не сохраняются этим списком. (Другими словами этот метод должен выделить новый массив, даже если этот список поддерживается массивом). Вызывающая сторона таким образом свободна изменить возвращенный массив.
    Этот метод действует как мост между основанными на массиве и основанными на наборе API.
    
    Определенный:
    
    toArray в интерфейсе Collection<E>
    
    Возвраты:
    массив, содержащий все элементы в этом списке в надлежащей последовательности
    См. Также:
    Arrays.asList(Object[])
  - toArray
```
<T> T[] toArray(T[] a)
```
    Возвращает массив, содержащий все элементы в этом списке в надлежащей последовательности (от сначала, чтобы продлиться элемент); тип времени выполнения возвращенного массива является типом указанного массива. Если список помещается в указанный массив, он возвращается туда. Иначе, новый массив выделяется с типом времени выполнения указанного массива и размером этого списка.
    Если список помещается в указанный массив с комнатой, чтобы сэкономить (то есть, у массива есть больше элементов чем список), элемент в массиве сразу после конца списка устанавливается в null. (Это полезно в определении длины списка, только если вызывающая сторона знает, что список не содержит нулевых элементов.)
    Как toArray() метод, этот метод действует как мост между основанными на массиве и основанными на наборе API. Далее, этот метод позволяет точное управление типом времени выполнения выходного массива, и, при определенных обстоятельствах, может использоваться, чтобы сохранить затраты выделения.
    Предположите, что x является списком, который, как известно, содержал только строки. Следующий код может использоваться, чтобы вывести список в недавно выделенный массив String:
```
     String[] y = x.toArray(new String[0]);
```
    Отметьте, что toArray(new Object[0]) идентичен в функции toArray().
    Определенный:
    
    toArray в интерфейсе Collection<E>
    
    Параметры:
    a - массив, в который должны быть сохранены элементы этого списка, если это является достаточно большим; иначе, новый массив того же самого типа времени выполнения выделяется с этой целью.
    
    Возвраты:
    массив, содержащий элементы этого списка
    
    Броски:
    
    ArrayStoreException - если тип времени выполнения указанного массива не является супертипом типа времени выполнения каждого элемента в этом списке
    
    NullPointerException - если указанный массив является нулем
  - добавить
```
boolean add(E e)
```
    Добавляет указанный элемент до конца этого списка (дополнительная работа).
    Списки, которые поддерживают эту работу, могут поместить ограничения на то, какие элементы могут быть добавлены к этому списку. В частности некоторые списки откажутся добавить нулевые элементы, и другие введут ограничения для типа элементов, которые могут быть добавлены. Классы списка должны ясно определить в их документации любые ограничения на то, какие элементы могут быть добавлены.
    
    Определенный:
    
    add в интерфейсе Collection<E>
    
    Параметры:
    e - элемент, который будет добавлен к этому списку
    
    Возвраты:
    true (как определено Collection.add(E))
    
    Броски:
    
    UnsupportedOperationException - если работа add не поддерживается этим списком
    
    ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этому списку
    
    NullPointerException - если указанный элемент является нулем, и этот список не разрешает нулевые элементы
    
    IllegalArgumentException - если некоторое свойство этого элемента препятствует тому, чтобы это было добавлено к этому списку
  - удалить
```
boolean remove(Object o)
```
    Удаляет первое возникновение указанного элемента от этого списка, если это присутствует (дополнительная работа). Если этот список не содержит элемент, это неизменно. Более формально, удаляет элемент с самым низким индексом i так, что (o==null ? get(i)==null : o.equals(get(i))) (если такой элемент существует). Возвраты true, если этот список, содержавший указанный элемент (или эквивалентно, если этот список, измененный в результате вызова).
    
    Определенный:
    
    remove в интерфейсе Collection<E>
    
    Параметры:
    o - элемент, который будет удален из этого списка, если существующий
    
    Возвраты:
    true, если этот список, содержавший указанный элемент
    
    Броски:
    
    ClassCastException - если тип указанного элемента является несовместимым с этим (дополнительным) списком
    
    NullPointerException - если указанный элемент является нулем, и этот список не разрешает нулевые (дополнительные) элементы
    
    UnsupportedOperationException - если работа remove не поддерживается этим списком
  - containsAll
```
boolean containsAll(Collection<?> c)
```
    true возвратов, если этот список содержит все элементы указанного набора.
    
    Определенный:
    
    containsAll в интерфейсе Collection<E>
    
    Параметры:
    c - набор, который будет проверен на включение в этом списке
    
    Возвраты:
    true, если этот список содержит все элементы указанного набора
    
    Броски:
    
    ClassCastException - если типы одного или более элементов в указанном наборе являются несовместимыми с этим (дополнительным) списком
    
    NullPointerException - если указанный набор содержит один или более нулевых элементов, и этот список не разрешает нулевые (дополнительные) элементы, или если указанный набор является нулем
    См. Также:
    contains(Object)
  - addAll
```
boolean addAll(Collection<? extends E> c)
```
    Добавляет все элементы в указанном наборе до конца этого списка, в порядке, что они возвращаются iterator указанного набора (дополнительная работа). Поведение этой работы неопределено, если указанный набор изменяется, в то время как работа происходит. (Отметьте, что это произойдет, если указанный набор будет этим списком, и это непусто.)
    
    Определенный:
    
    addAll в интерфейсе Collection<E>
    
    Параметры:
    c - набор, содержащий элементы, которые будут добавлены к этому списку
    
    Возвраты:
    true, если этот список изменился в результате вызова
    
    Броски:
    
    UnsupportedOperationException - если работа addAll не поддерживается этим списком
    
    ClassCastException - если класс элемента указанного набора препятствует тому, чтобы это было добавлено к этому списку
    
    NullPointerException - если указанный набор содержит один или более нулевых элементов, и этот список не разрешает нулевые элементы, или если указанный набор является нулем
    
    IllegalArgumentException - если некоторое свойство элемента указанного набора препятствует тому, чтобы это было добавлено к этому списку
    См. Также:
    add(Object)
  - addAll
```
boolean addAll(int index,
             Collection<? extends E> c)
```
    Вставляет все элементы в указанном наборе в этот список в указанной позиции (дополнительная работа). Смещает элемент в настоящий момент в той позиции (если любой) и любые последующие элементы направо (увеличивает их индексы). Новые элементы появятся в этом списке в порядке, что они возвращаются iterator указанного набора. Поведение этой работы неопределено, если указанный набор изменяется, в то время как работа происходит. (Отметьте, что это произойдет, если указанный набор будет этим списком, и это непусто.)
    
    Параметры:
    index - индекс, по которому можно вставить первый элемент от указанного набора
    c - набор, содержащий элементы, которые будут добавлены к этому списку
    
    Возвраты:
    true, если этот список изменился в результате вызова
    
    Броски:
    
    UnsupportedOperationException - если работа addAll не поддерживается этим списком
    
    ClassCastException - если класс элемента указанного набора препятствует тому, чтобы это было добавлено к этому списку
    
    NullPointerException - если указанный набор содержит один или более нулевых элементов, и этот список не разрешает нулевые элементы, или если указанный набор является нулем
    
    IllegalArgumentException - если некоторое свойство элемента указанного набора препятствует тому, чтобы это было добавлено к этому списку
    
    IndexOutOfBoundsException - если индекс испытывает недостаток диапазона (index < 0 || index > size())
  - removeAll
```
boolean removeAll(Collection<?> c)
```
    Удаляет из этого списка все его элементы, которые содержатся в указанном наборе (дополнительная работа).
    
    Определенный:
    
    removeAll в интерфейсе Collection<E>
    
    Параметры:
    c - набор, содержащий элементы, которые будут удалены из этого списка
    
    Возвраты:
    true, если этот список изменился в результате вызова
    
    Броски:
    
    UnsupportedOperationException - если работа removeAll не поддерживается этим списком
    
    ClassCastException - если класс элемента этого списка является несовместимым с указанным (дополнительным) набором
    
    NullPointerException - если этот список содержит нулевой элемент, и указанный набор не разрешает нулевые (дополнительные) элементы, или если указанный набор является нулем
    См. Также:
    remove(Object), contains(Object)
  - retainAll
```
boolean retainAll(Collection<?> c)
```
    Сохраняет только элементы в этом списке, которые содержатся в указанном наборе (дополнительная работа). Другими словами, удаляет из этого списка все его элементы, которые не содержатся в указанном наборе.
    
    Определенный:
    
    retainAll в интерфейсе Collection<E>
    
    Параметры:
    c - набор, содержащий элементы, которые будут сохранены в этом списке
    
    Возвраты:
    true, если этот список изменился в результате вызова
    
    Броски:
    
    UnsupportedOperationException - если работа retainAll не поддерживается этим списком
    
    ClassCastException - если класс элемента этого списка является несовместимым с указанным (дополнительным) набором
    
    NullPointerException - если этот список содержит нулевой элемент, и указанный набор не разрешает нулевые (дополнительные) элементы, или если указанный набор является нулем
    См. Также:
    remove(Object), contains(Object)
  - очистить
```
void clear()
```
    Удаляет все элементы от этого списка (дополнительная работа). Список будет пуст после этого вызова возвраты.
    
    Определенный:
    
    clear в интерфейсе Collection<E>
    
    Броски:
    
    UnsupportedOperationException - если работа clear не поддерживается этим списком
  - равняется
```
boolean equals(Object o)
```
    Сравнивает указанный объект с этим списком для равенства. Возвраты у true, если и только если указанный объект является также списком, оба списка, есть тот же самый размер, и все соответствующие пары элементов в двух списках, равны. (Два элемента e1 и e2 равны если (e1==null ? e2==null : e1.equals(e2)).) Другими словами два списка определяются, чтобы быть равными, если они содержат те же самые элементы в том же самом порядке. Это определение гарантирует, что равняется работам метода должным образом через различные реализации интерфейса List.
    
    Определенный:
    
    equals в интерфейсе Collection<E>
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    o - объект, который будет сравнен для равенства с этим списком
    
    Возвраты:
    true, если указанный объект равен этому списку
    См. Также:
    Object.hashCode(), HashMap
  - хэш-код
```
int hashCode()
```
    Возвращает значение хэш-кода для этого списка. Хэш-код списка определяется, чтобы быть результатом следующего вычисления:
```
  int hashCode = 1;
  for (E e : list)
      hashCode = 31*hashCode + (e==null ? 0 : e.hashCode());
 
```
    Это гарантирует, что list1.equals(list2) подразумевает что list1.hashCode()==list2.hashCode() для любых двух списков, list1 и list2, как требуется согласно общему контракту Object.hashCode().
    Определенный:
    
    hashCode в интерфейсе Collection<E>
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    значение хэш-кода для этого списка
    См. Также:
    Object.equals(Object), equals(Object)
  - добраться
```
E get(int index)
```
    Возвращает элемент в указанной позиции в этом списке.
    
    Параметры:
    index - индекс элемента, чтобы возвратиться
    
    Возвраты:
    элемент в указанной позиции в этом списке
    
    Броски:
    
    IndexOutOfBoundsException - если индекс испытывает недостаток диапазона (index < 0 || index >= size())
  - набор
```
E set(int index,
    E element)
```
    Заменяет элемент в указанной позиции в этом списке с указанным элементом (дополнительная работа).
    
    Параметры:
    index - индекс элемента, чтобы заменить
    element - элемент, который будет сохранен в указанной позиции
    
    Возвраты:
    элемент ранее в указанной позиции
    
    Броски:
    
    UnsupportedOperationException - если работа set не поддерживается этим списком
    
    ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этому списку
    
    NullPointerException - если указанный элемент является нулем, и этот список не разрешает нулевые элементы
    
    IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этому списку
    
    IndexOutOfBoundsException - если индекс испытывает недостаток диапазона (index < 0 || index >= size())
  - добавить
```
void add(int index,
       E element)
```
    Вставляет указанный элемент в указанной позиции в этом списке (дополнительная работа). Смещает элемент в настоящий момент в той позиции (если любой) и любые последующие элементы направо (добавляет тот к их индексам).
    
    Параметры:
    index - индекс, по которому должен быть вставлен указанный элемент
    element - элемент, который будет вставлен
    
    Броски:
    
    UnsupportedOperationException - если работа add не поддерживается этим списком
    
    ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этому списку
    
    NullPointerException - если указанный элемент является нулем, и этот список не разрешает нулевые элементы
    
    IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этому списку
    
    IndexOutOfBoundsException - если индекс испытывает недостаток диапазона (index < 0 || index > size())
  - удалить
```
E remove(int index)
```
    Удаляет элемент в указанной позиции в этом списке (дополнительная работа). Сдвиги любые последующие элементы налево (вычитает один из их индексов). Возвращает элемент, который был удален из списка.
    
    Параметры:
    index - индекс элемента, который будет удален
    
    Возвраты:
    элемент ранее в указанной позиции
    
    Броски:
    
    UnsupportedOperationException - если работа remove не поддерживается этим списком
    
    IndexOutOfBoundsException - если индекс испытывает недостаток диапазона (index < 0 || index >= size())
  - indexOf
```
int indexOf(Object o)
```
    Возвращает индекс первого возникновения указанного элемента в этом списке, или-1, если этот список не содержит элемент. Более формально, возвращает самый низкий индекс i так, что (o==null ? get(i)==null : o.equals(get(i))), или-1, если нет такого индекса.
    
    Параметры:
    o - элемент, чтобы искать
    
    Возвраты:
    индекс первого возникновения указанного элемента в этом списке, или-1, если этот список не содержит элемент
    
    Броски:
    
    ClassCastException - если тип указанного элемента является несовместимым с этим (дополнительным) списком
    
    NullPointerException - если указанный элемент является нулем, и этот список не разрешает нулевые (дополнительные) элементы
  - lastIndexOf
```
int lastIndexOf(Object o)
```
    Возвращает индекс последнего вхождения указанного элемента в этом списке, или-1, если этот список не содержит элемент. Более формально, возвращает самый высокий индекс i так, что (o==null ? get(i)==null : o.equals(get(i))), или-1, если нет такого индекса.
    
    Параметры:
    o - элемент, чтобы искать
    
    Возвраты:
    индекс последнего вхождения указанного элемента в этом списке, или-1, если этот список не содержит элемент
    
    Броски:
    
    ClassCastException - если тип указанного элемента является несовместимым с этим (дополнительным) списком
    
    NullPointerException - если указанный элемент является нулем, и этот список не разрешает нулевые (дополнительные) элементы
  - listIterator
```
ListIterator<E> listIterator()
```
    Возвращает список iterator по элементам в этом списке (в надлежащей последовательности).
    
    Возвраты:
    список iterator по элементам в этом списке (в надлежащей последовательности)
  - listIterator
```
ListIterator<E> listIterator(int index)
```
    Возвращает список iterator по элементам в этом списке (в надлежащей последовательности), запускаясь в указанной позиции в списке. Указанный индекс указывает на первый элемент, который был бы возвращен начальным вызовом next. Начальный вызов previous возвратил бы элемент с указанным индексом минус один.
    
    Параметры:
    index - индекс первого элемента, который будет возвращен из списка iterator (звонком next)
    
    Возвраты:
    список iterator по элементам в этом списке (в надлежащей последовательности), запускаясь в указанной позиции в списке
    
    Броски:
    
    IndexOutOfBoundsException - если индекс испытывает недостаток диапазона (index < 0 || index > size())
  - подсписок
```
List<E> subList(int fromIndex,
              int toIndex)
```
    Возвращает представление части этого списка между указанным fromIndex, включительно, и toIndex, монопольным. (Если fromIndex и toIndex равны, возвращенный список пуст.) Возвращенный список поддерживается этим списком, таким образом, неструктурные изменения в возвращенном списке отражаются в этом списке, и наоборот. Возвращенный список поддерживает все дополнительные операции списка, поддерживаемые этим списком.
    Этот метод избавляет от необходимости явные операции диапазона (вида, которые обычно существуют для массивов). Любая работа, которая ожидает список, может использоваться в качестве работы диапазона, передавая представление подсписка вместо целого списка. Например, следующая идиома удаляет диапазон элементов от списка:
```
      list.subList(from, to).clear();
 
```
    Подобные идиомы могут быть созданы для indexOf и lastIndexOf, и все алгоритмы в классе Collections могут быть применены к подсписку.
    Семантика списка, возвращенного этим методом, становится неопределенной, если отступающий список (то есть, этот список) структурно изменяются всегда кроме через возвращенный список. (Структурные модификации - те, которые изменяют размер этого списка, или иначе тревожат это таким способом, что происходящие итерации могут привести к неправильным результатам.)
    Параметры:
    fromIndex - низкая конечная точка (включительно) подсписка
    toIndex - высокая конечная точка (монопольная) из подсписка
    
    Возвраты:
    представление указанного диапазона в пределах этого списка
    
    Броски:
    
    IndexOutOfBoundsException - поскольку недопустимая конечная точка индексирует значение (fromIndex < 0 || toIndex > size || fromIndex > toIndex)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный Список <E>

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

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

размер

isEmpty

содержит

iterator

toArray

toArray

добавить

удалить

containsAll

addAll

addAll

removeAll

retainAll

очистить

равняется

хэш-код

добраться

набор

добавить

удалить

indexOf

lastIndexOf

listIterator

listIterator

подсписок