Спецификация языка Java Пакет java.util


Содержание | Предыдущий | Следующий | Индекс

21.11 Класс java.util.Vector

A Vector, как массив, содержит элементы, к которым можно получить доступ, используя целочисленный индекс. Однако, размер a Vector может вырасти и уменьшиться как необходимый разместить добавление и удаление элементов после Vector был создан.

public class Vector implements Cloneable {
	protected Object[] elementData;
	protected int elementCount;
	protected int capacityIncrement;
	public Vector(int initialCapacity, int capacityIncrement);
	public Vector(int initialCapacity);
	public Vector();
	public final String toString();
	public Object clone();
	public final Object elementAt(int index)
		throws IndexOutOfBoundsException;
	public final void setElementAt(Object obj, int index)
		throws IndexOutOfBoundsException;
	public final Object firstElement()
		throws NoSuchElementException;
	public final Object lastElement()
		throws NoSuchElementException;
	public final void addElement(Object obj);
	public final void insertElementAt(Object obj, int index)
		throws IndexOutOfBoundsException;
	public final boolean removeElement(Object obj);
	public final void removeElementAt(int index)
		throws IndexOutOfBoundsException;
	public final void removeAllElements();
	public final boolean isEmpty();
	public final int size();
	public final void setSize(int newSize);
	public final int capacity();
	public final void ensureCapacity(int minCapacity);
	public final void trimToSize();
	public final void copyInto(Object anArray[])
		throws IndexOutOfBoundsException;
	public final Enumeration elements();
	public final boolean contains(Object elem);
	public final int indexOf(Object elem);
	public final int indexOf(Object elem, int index)
		throws IndexOutOfBoundsException;
	public final int lastIndexOf(Object elem);
	public final int lastIndexOf(Object elem, int index)
		throws IndexOutOfBoundsException;
}

21.11.1 protected Object[] elementData;

Внутренне, a Vector сохраняет его элементы в массиве, который является, по крайней мере, достаточно многочисленным, чтобы содержать все элементы.

21.11.2 protected int elementCount;

Это поле содержит число элементов в настоящий момент в этом Vector объект. Компоненты elementData[0] через elementData[elementCount-1] фактические элементы.

21.11.3 protected int capacityIncrement;

Когда метод ensureCapacity (§21.11.22) должен увеличить размер массива данных в поле elementData (создавая новый массив), это увеличивает размер, по крайней мере, количеством в capacityIncrement; но если capacityIncrement нуль, тогда он, по крайней мере, удваивает размер массива данных.

21.11.4 public Vector(int initialCapacity, int capacityIncrement)

Этот конструктор инициализирует недавно создаваемый Vector так, чтобы у его внутреннего массива данных был размер initialCapacity и его стандартный инкремент емкости является значением capacityIncrement. Первоначально, Vector не содержит элементов.

21.11.5 public Vector(int initialCapacity)

Этот конструктор инициализирует недавно создаваемый Vector так, чтобы у его внутреннего массива данных был размер initialCapacity и его стандартный инкремент емкости является нулем. Первоначально, Vector не содержит элементов.

21.11.6 public Vector()

Этот конструктор инициализирует недавно создаваемый Vector так, чтобы у его внутреннего массива данных был размер 10 и его стандартный инкремент емкости является нулем. Первоначально Vector не содержит элементов.

21.11.7 public final String toString()

Это Vector представляется в строковой форме как список ее элементов, включил в квадратные скобки ASCII и отделился символами ASCII", "(запятая и пространство). toString метод используется, чтобы преобразовать элементы в строки; нулевая ссылка представляется как строка"null".

Фрагмент в качестве примера:


Vector v = new Vector();
v.addElement("Canberra");
v.addElement("Cancun");
v.addElement("Canandaigua");
System.out.println(v.toString());

производит вывод:

[Canberra, Cancun, Canandaigua]
Переопределения toString метод Object (§20.1.2).

21.11.8 public Object clone()

Копия этого Vector создается и возвращается. Копия будет содержать ссылку на клона внутреннего массива данных, не ссылку на исходный внутренний массив данных этого Vector.

Переопределения clone метод Object (§20.1.5).

21.11.9 public final Object elementAt(int index)
throws IndexOutOfBoundsException

Элемент этого Vector с указанным index возвращается.

Если index отрицательно или не меньше чем текущий размер этого Vector, IndexOutOfBoundsException бросается.

21.11.10 public final void setElementAt(Object obj, int index)
throws IndexOutOfBoundsException

Элемент этого Vector с указанным index заменяется obj, так, чтобы obj теперь элемент в указанном index в пределах этого Vector.

Если index отрицательно или не меньше чем текущий размер этого Vector, IndexOutOfBoundsException бросается.

21.11.11 public final Object firstElement()
throws NoSuchElementException

Если это Vector пусто, a NoSuchElementException бросается. Иначе, первый элемент (элемент по индексу 0) возвращается.

21.11.12 public final Object lastElement()
throws NoSuchElementException

Если это Vector пусто, a NoSuchElementException бросается. Иначе, последний элемент (элемент по индексу size()-1) возвращается.

21.11.13 public final void addElement(Object obj)

Размер этого Vector увеличивается 1 и obj становится новым последним элементом.

21.11.14 public final void insertElementAt(Object obj, int index)
throws IndexOutOfBoundsException

Размер этого Vector увеличивается 1 и obj становится новым элементом в указанном index. Любой элемент в этом Vector это было ранее по индексу k сначала перемещается в индекс k+1 если и только если k не меньше чем index.

21.11.15 public final boolean removeElement(Object obj)

Если это Vector содержит возникновение obj, тогда первое (индексированное самым низким образом) такое возникновение, удаляется, как будто методом removeElementAt (§21.11.16), и true возвращается. Если это Vector не содержит возникновения obj, это Vector не изменяется и false возвращается.

21.11.16 public final void removeElementAt(int index)
throws IndexOutOfBoundsException

Размер этого Vector уменьшается 1 и элемент в указанном index удаляется из этого Vector. Любой элемент в этом Vector это было ранее по индексу k сначала перемещается в индекс k-1 если и только если k больше чем index.

21.11.17 public final void removeAllElements()

Все элементы удаляются из этого Vector, создание этого пустой.

21.11.18 public final boolean isEmpty()

Результат true если и только если это Vector пусто, то есть, его размер является нулем.

21.11.19 public final int size()

Размер этого Vector (число элементов, которые это в настоящий момент содержит), возвращается.

21.11.20 public final void setSize(int newSize)

Размер этого Vector изменяется на newSize. Если новый размер меньше чем старый размер, то элементы удаляются из конца и отбрасываются. Если новый размер больше чем старый размер, то новые элементы устанавливаются в null.

21.11.21 public final int capacity()

Текущая емкость этого Vector (длина его внутреннего массива данных, сохраненного в поле elementData) возвращается.

21.11.22 public final void ensureCapacity(int minCapacity)

Если текущая емкость этого Vector меньше чем minCapacity, тогда его емкость увеличивается, заменяя его внутренний массив данных, сохраненный в поле elementData (§21.11.1), с большим. Размер нового массива данных будет старым размером плюс capacityIncrement (§21.11.3), если значение capacityIncrement неположительно, когда новая емкость будет дважды старой емкостью; но если этот новый размер все еще меньше чем minCapacity, тогда новая емкость будет minCapacity.

21.11.23 public final void trimToSize()

Если емкость этого Vector больше чем его ток size (§21.11.19), тогда емкость изменяется, чтобы равняться размеру, заменяя его внутренний массив данных, сохраненный в поле elementData, с меньшим.

21.11.24 public final void copyInto(Object anArray[])
throws IndexOutOfBoundsException

Все элементы в этом Vector копируются в массив anArray. Элемент по индексу k в этом Vector копируется в компонент k из anArray. Если длина anArray меньше чем размер этого Vector, IndexOutOfBoundsException бросается.

21.11.25 public final Enumeration elements()

Enumeration (§21.1) возвращается, который генерирует все элементы в этом Vector. Первый сгенерированный элемент является элементом по индексу 0, тогда элемент по индексу 1, и так далее.

21.11.26 public final boolean contains(Object elem)

Результат true если и только если некоторый элемент в этом Vector то же самое как elem, как определено equals метод (§20.1.3).

21.11.27 public final int indexOf(Object elem)

Если элемент, равный elem находится в этом Vector, тогда индекс первого такое возникновение возвращается, то есть, самое маленькое значение k так, что:

elem.equals(elementData[k])
true. Если никакой такой элемент не происходит в этом Vector, тогда -1 возвращается.

21.11.28 public final int indexOf(Object elem, int index)
throws IndexOutOfBoundsException

Если элемент, равный elem находится в этом Vector в позиции k или выше, тогда индекс первого такое возникновение возвращается, то есть, самое маленькое значение k так, что:

elem.equals(elementData[k]) && (k >= index)
true. Если никакой такой элемент не происходит в этом Vector, тогда -1 возвращается.

21.11.29 public final int lastIndexOf(Object elem)

Если элемент, равный elem находится в этом Vector, тогда индекс последнего такое возникновение возвращается, то есть, самое большое значение k так, что:

elem.equals(elementData[k])
true. Если никакой такой элемент не происходит в этом Vector, тогда -1 возвращается.

21.11.30 public final int lastIndexOf(Object elem, int index)
throws IndexOutOfBoundsException

Если элемент, равный elem находится в этом Vector в позиции k или ниже, тогда индекс последнего такое возникновение возвращается, то есть, самое большое значение k так, что:

elem.equals(elementData[k]) && (k <= index)
true. Если никакой такой элемент не происходит в этом Vector, тогда -1 возвращается.


Содержание | Предыдущий | Следующий | Индекс

Спецификация языка Java (HTML, сгенерированный Блинчиком "сюзет" Pelouch 24 февраля 1998)
Авторское право © Sun Microsystems, Inc 1996 года. Все права защищены
Пожалуйста, отправьте любые комментарии или исправления к doug.kramer@sun.com



Spec-Zone.ru - all specs in one place



free hit counter