std::vector::vector

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека контейнеров

Последовательные

array (C++11)

vector

vector<bool>

deque

forward_list (C++11)

list

Ассоциативные

set

multiset

map

multimap

Неупорядоченные ассоциативные

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Адаптеры

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Представления

span (C++20)

mdspan (C++23)

Недействительные итераторы

Таблица функций-элементов

Таблица функций, не являющихся элементами

 

std::vector

Типы элементы

Функции элементы

vector::vector

vector::~vector

vector::operator=

vector::assign

vector::assign_range (C++23)

vector::get_allocator

Доступ к элементам

vector::at

vector::operator[]

vector::front

vector::back

vector::data

Итераторы

vector::beginvector::cbegin (C++11)

vector::endvector::cend (C++11)

vector::rbeginvector::crbegin (C++11)

vector::rendvector::crend (C++11)

Ёмкость

vector::empty

vector::size

vector::max_size

vector::reserve

vector::capacity

vector::shrink_to_fit (DR*)

Модификаторы

vector::clear

vector::insert

vector::emplace (C++11)

vector::insert_range (C++23)

vector::erase

vector::push_back

vector::emplace_back (C++11)

vector::append_range (C++23)

vector::pop_back

vector::resize

vector::swap

Функции, не являющиеся элементами

std::swap

eraseerase_if (C++20)(C++20)

operator==operator!=operator<operator>operator<=operator>=operator<=> (до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)

Принципы вывода (C++17)

 

<tbody> </tbody>

explicit vector( const Allocator& alloc = Allocator() );	(1)
explicit vector( size_type count, {{#pad:|6}} const T& value = T(), {{#pad:|6}} const Allocator& alloc = Allocator()); vector( size_type count, {{#pad:|6}} const T& value, {{#pad:|6}} const Allocator& alloc = Allocator());	(2)	(до C++11) (начиная с C++11)
explicit vector( size_type count );	(3)	(начиная с C++11)
template< class InputIt > vector( InputIt first, InputIt last, {{#pad:|6}} const Allocator& alloc = Allocator() );	(4)
vector( const vector& other );	(5)
vector( const vector& other, const Allocator& alloc );	(5)	(начиная с C++11)
vector( vector&& other )	(6)	(начиная с C++11)
vector( vector&& other, const Allocator& alloc );	(6)	(начиная с C++11)
vector( std::initializer_list<T> init, {{#pad:|6}} const Allocator& alloc = Allocator() );	(7)	(начиная с C++11)

Создает новый контейнер из разнообразных источников данных, возможно, используя предоставленный пользователем аллокатор alloc.

1) Конструктор по умолчанию. Создает пустой контейнер.

2) Создает контейнер с count копиями элемента со значением value.

3) Создает контейнер с count экземплярами T, инициализированными конструктором по-умолчанию. При этом копирования не происходит.

4) Создает контейнер с содержимым диапазона [first, last).

5) Конструктор копирования. Создает контейнер с копией содержимого other. Если alloc не задан, аллокатор будет получен вызовом std::allocator_traits<allocator_type>::select_on_copy_construction(other).

6) Конструктор перемещения. Создает контейнер с содержимым other путём перемещения данных. Если alloc не задан, аллокатор будет получен перемещением аллокатора other.

7) Создает контейнер с содержимым списка инициализации init.

Параметры

alloc	—	Аллокатор, используемый для всех выделений памяти в контейнере.
count	—	Размер контейнера.
value	—	Значение, которым будут инициализированы элементы контейнера.
first, last	—	Диапазон, из которого копируются элементы.
other	—	другой контейнер, который будет использоваться в качестве источника для инициализации элементов контейнера.
init	—	список инициализации элементов контейнера.
Требования к типам
- InputIt должен соответствовать требованиям InputIterator.

Сложность

1) Константа.

2-3) Линейная относительно count.

4) Линейная относительно расстояния между first и last.

5) Линейная относительно размера other

6) Константа. Если alloc задан и alloc != other.get_allocator(), то линейная.

7) Линейная относительно размера init

Пример

Запустить этот код

#include <vector>
#include <string>

int main()
{
    // c++11 initializer list syntax:
    std::vector<std::string> words1 {"the", "frogurt", "is", "also", "cursed"};

    // words2 == words1
    std::vector<std::string> words2(words1.begin(), words1.end());

    // words3 == words1
    std::vector<std::string> words3(words1);

    // words4 is {"Mo", "Mo", "Mo", "Mo", "Mo"}
    std::vector<std::string> words4(5, "Mo");

    return 0;
}

См. также

assign	присваивает значения контейнеру (public функция-элемент)
operator=	присваивает значения контейнеру (public функция-элемент)