std::vector<T,Allocator>::vector

vector();

vector() noexcept(noexcept(Allocator()));

constexpr vector() noexcept(noexcept(Allocator()));

explicit vector( const Allocator& alloc );

explicit vector( const Allocator& alloc ) noexcept;

constexpr explicit vector( const Allocator& alloc ) noexcept;

explicit vector( size_type count,
                 const T& value = T(),
                 const Allocator& alloc = Allocator() );

vector( size_type count,
                 const T& value,
                 const Allocator& alloc = Allocator() );

constexpr vector( size_type count,
                  const T& value,
                  const Allocator& alloc = Allocator() );

explicit vector( size_type count );

explicit vector( size_type count,
                 const Allocator& alloc = Allocator() );

constexpr explicit vector( size_type count,
                           const Allocator& alloc = Allocator() );

template< class InputIt >
vector( InputIt first, InputIt last,
        const Allocator& alloc = Allocator() );

template< class InputIt >
constexpr vector( InputIt first, InputIt last,
                  const Allocator& alloc = Allocator() );

vector( const vector& other );

constexpr vector( const vector& other );

vector( const vector& other, const Allocator& alloc );

constexpr vector( const vector& other, const Allocator& alloc );

vector( vector&& other );

vector( vector&& other ) noexcept;

constexpr vector( vector&& other ) noexcept;

vector( vector&& other, const Allocator& alloc );

constexpr vector( vector&& other, const Allocator& alloc );

vector( std::initializer_list<T> init,
        const Allocator& alloc = Allocator() );

constexpr vector( std::initializer_list<T> init,
                  const Allocator& alloc = Allocator() );

template< container-compatible-range<T> R >
constexpr vector( std::from_range_t, R&& rg,
                  const Allocator& alloc = Allocator() );

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

Параметры

Сложность

• Если first и last являются итераторами вперёд, в обе стороны или произвольного доступа,
• Конструктор копирования T вызывается только N раз, и
• Перераспределение не происходит.
• В противном случае (first и last — итераторы только для чтения),
• Конструктор копирования T вызывается O(N) раз, и
• Перераспределение происходит O(log N) раз.

• Если R моделирует ranges::forward_range или ranges::sized_range,
• Инициализирует ровно N элементов из результата деференцирования последовательных итераторов rg, и
• Перераспределение не происходит.
• В противном случае (R моделирует диапазон входных данных),
• Копирующий или перемещающий конструктор T вызывается O(N) раз, и
• Перераспределение происходит O(log N) раз.

Исключения

Вызовы Allocator::allocate могут вызывать исключения.

Примечания

После перемещения контейнера (перегрузка (8)), ссылки, указатели и итераторы (кроме итератора конца) на other остаются действительными, но ссылаются на элементы, которые теперь находятся в *this. Текущий стандарт гарантирует это через общее утверждение в [container.reqmts]/67, и более прямое гарантирование рассматривается в LWG issue 2321.

Перегрузка (4) обнуляет элементы неклассовых типов, таких как int, что отличается от поведения new[], которое оставляет их неинициализированными. Для соответствия поведению new[] может быть предоставлен настраиваемый Allocator::construct, который оставляет такие элементы неинициализированными.

Обратите внимание, что наличие конструктора по списковой инициализации (10) означает, что инициализация списком и прямая инициализация делают разные вещи:

std::vector<int> b{3}; // creates a 1-element vector holding {3}
std::vector<int> d(3); // creates a 3-element vector holding {0, 0, 0}
 
std::vector<int> p{1, 2}; // creates a 2-element vector holding {1, 2}
std::vector<int> q(1, 2); // creates a 1-element vector holding {2}

Пример

#include <iostream>
#include <string>
#include <vector>
 
template<typename T>
std::ostream& operator<<(std::ostream& s, const std::vector<T>& v)
{
    s.put('{');
    for (char comma[]{'\0', ' ', '\0'}; const auto& e : v)
        s << comma << e, comma[0] = ',';
    return s << "}\n";
}
 
int main()
{
    // C++11 initializer list syntax:
    std::vector<std::string> words1{"the", "frogurt", "is", "also", "cursed"};
    std::cout << "1: " << words1;
 
    // words2 == words1
    std::vector<std::string> words2(words1.begin(), words1.end());
    std::cout << "2: " << words2;
 
    // words3 == words1
    std::vector<std::string> words3(words1);
    std::cout << "3: " << words3;
 
    // words4 is {"Mo", "Mo", "Mo", "Mo", "Mo"}
    std::vector<std::string> words4(5, "Mo");
    std::cout << "4: " << words4;
 
    auto const rg = {"cat", "cow", "crow"};
#ifdef __cpp_lib_containers_ranges
    std::vector<std::string> words5(std::from_range, rg); // overload (11)
#else
    std::vector<std::string> words5(rg.begin(), rg.end()); // overload (5)
#endif
    std::cout << "5: " << words5;
}

1: {the, frogurt, is, also, cursed}
2: {the, frogurt, is, also, cursed}
3: {the, frogurt, is, also, cursed}
4: {Mo, Mo, Mo, Mo, Mo}
5: {cat, cow, crow}

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также