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

vector() : vector(Allocator()) {}

vector() noexcept(noexcept(Allocator())) : vector(Allocator()) {}

explicit vector( const Allocator& alloc = Allocator() );

explicit vector( const Allocator& alloc );

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

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

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

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

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

vector( const vector& other );

vector( vector&& other );

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

constexpr vector( const vector& other,
                  const std::type_identity_t<Allocator>& alloc );

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

constexpr vector( vector&& other,
                  const std::type_identity_t<Allocator>& alloc );

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

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

• T не является EmplaceConstructible в std::vector<T> из *ranges::begin(rg).
• R моделирует ни sized_range, ни forward_range, а T не является MoveInsertable в std::vector<T>.

Параметры

Сложность

• Если 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 2321.

Пример

#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;
    
    const auto rg = {"cat", "cow", "crow"};
#ifdef __cpp_lib_containers_ranges
    std::vector<std::string> words5(std::from_range, rg); // overload (6)
#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++.

См. также