26 Containers library [containers]

26.3 Sequence containers [sequences]

26.3.11 Class template vector [vector]

26.3.11.3 vector capacity [vector.capacity]

size_type capacity() const noexcept;

1
#

Returns: Общее количество элементов, которые вектор может содержать без необходимости перераспределения.

void reserve(size_type n);

2
#

Requires: T должен быть MoveInsertable в *this.

3
#

Effects: Директива, которая информирует vector о планируемом изменении размера, чтобы он мог соответствующим образом управлять распределением хранилища. После того, какreserve(), capacity() больше или равен аргументу ,reserve если Перераспределение происходит; и равно предыдущему значению в capacity() противном случае. Перераспределение происходит в этот момент тогда и только тогда, когда текущая емкость меньше аргумента reserve(). Если исключение выбрасывается не конструктором перемещения не-CopyInsertable типа, не будет никаких эффектов.

4
#

Complexity: Он не изменяет размер последовательности и занимает самое большее линейное время в размере последовательности.

5
#

Throws: length_­error если n > max_­size().260

6
#

Remarks: Перераспределение делает недействительными все ссылки, указатели и итераторы, относящиеся к элементам в последовательности. Никакое перераспределение не должно происходить во время вставок, которые происходят после вызова, reserve() до того момента, когда вставка сделает размер вектора больше, чем значение capacity().

void shrink_to_fit();

7
#

Requires: T должен быть MoveInsertable в *this.

8
#

Effects: shrink_­to_­fit является необязательным запросом для сокращения capacity() до size(). [  Note: Запрос не является обязывающим, чтобы дать свободу для оптимизации, зависящей от реализации. ] Он не увеличивается , но может уменьшаться , вызывая перераспределение. Если исключение вызвано другим, чем конструктором перемещения объекта non- , никаких эффектов не возникает.  — end note  capacity() capacity()CopyInsertable T

9
#

Complexity: Линейный по размеру последовательности.

10
#

Remarks: Перераспределение делает недействительными все ссылки, указатели и итераторы, относящиеся к элементам в последовательности, а также к итератору, прошедшему конец. Если перераспределения не происходит, они остаются в силе.

void swap(vector& x) noexcept(allocator_traits<Allocator>::propagate_on_container_swap::value || allocator_traits<Allocator>::is_always_equal::value);

11
#

Effects: Обмены содержания и capacity() о *this с у x.

12
#

Complexity: Постоянное время.

void resize(size_type sz);

13
#

Effects: Если sz < size(), стирает последние size() - sz элементы из последовательности. В противном случае добавляет sz - size() в последовательность элементы, вставленные по умолчанию.

14
#

Requires: T должно быть MoveInsertable и DefaultInsertable в *this.

15
#

Remarks: Если исключение вызвано другим, чем конструктором перемещения объекта non-CopyInsertable T , никаких эффектов не возникает.

void resize(size_type sz, const T& c);

16
#

Effects: Если sz < size(), стирает последние size() - sz элементы из последовательности. В противном случае добавляет к последовательности sz - size() копии c .

17
#

Requires: T должен быть CopyInsertable в *this.

18
#

Remarks: Если выбрано исключение, никаких эффектов нет.

260)

reserve() использования, Allocator​::​allocate() которые могут вызвать соответствующее исключение.