Namespaces
Variants

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

From cppreference.net
C++
Containers library
std::vector
Member types
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
(1)
vector ( ) : vector ( Allocator ( ) ) { }
(C++11부터)
(C++17까지)
vector ( ) noexcept ( noexcept ( Allocator ( ) ) ) : vector ( Allocator ( ) ) { }
(C++17부터)
(C++20부터 constexpr)
(2)
explicit vector ( const Allocator & alloc = Allocator ( ) ) ;
(C++11 이전)
explicit vector ( const Allocator & alloc ) ;
(C++11 이후)
(C++17부터 noexcept)
(C++20부터 constexpr)
explicit vector ( size_type count,
const Allocator & alloc = Allocator ( ) ) ;
(3) (C++11부터)
(4)
explicit vector ( size_type count, const T & value = T ( ) ,
const Allocator & alloc = Allocator ( ) ) ;
(C++11 이전)
vector ( size_type count, const T & value,
const Allocator & alloc = Allocator ( ) ) ;
(C++11 이후)
(C++20 이후 constexpr)
template < class InputIt >

vector ( InputIt first, InputIt last,

const Allocator & alloc = Allocator ( ) ) ;
(5) (constexpr since C++20)
template < container-compatible-range < T > R >

constexpr vector ( std:: from_range_t , R && rg,

const Allocator & alloc = Allocator ( ) ) ;
(6) (since C++23)
vector ( const vector & other ) ;
(7) (constexpr since C++20)
vector ( vector && other ) ;
(8) (since C++11)
(noexcept since C++17)
(constexpr since C++20)
(9)
vector ( const vector & other, const Allocator & alloc ) ;
(C++11부터)
(C++20부터 constexpr)
(C++23까지)
constexpr vector ( const vector & other,
const std:: type_identity_t < Allocator > & alloc ) ;
(C++23부터)
(10)
vector ( vector && other, const Allocator & alloc ) ;
(C++11부터)
(C++23 이전까지)
constexpr vector ( vector && other,
const std:: type_identity_t < Allocator > & alloc ) ;
(C++23부터)
vector ( std:: initializer_list < T > init,
const Allocator & alloc = Allocator ( ) ) ;
(11) (C++11 이후)

다양한 데이터 소스로부터 새로운 vector 를 생성하며, 선택적으로 사용자가 제공한 할당자 alloc 을 사용합니다.

1) C++11부터 도입된 기본 생성자. 기본 생성된 할당자와 함께 빈 vector 를 생성합니다.
만약 Allocator 가 DefaultConstructible 가 아닐 경우, 동작은 정의되지 않습니다.
2) C++11 이전의 기본 생성자. 주어진 할당자 alloc 를 사용하여 빈 vector 를 생성합니다.
3) count 개의 기본 삽입된 T 객체로 구성된 vector 를 생성합니다. 복사본은 생성되지 않습니다.
만약 T 가 DefaultInsertable 이 vector 에 삽입 가능하지 않다면, 동작은 정의되지 않습니다.
4) vector 를 count 개의 value 값으로 구성된 요소들로 생성합니다.

만약 T 가 CopyInsertable 요구사항을 vector 에서 만족하지 않으면, 동작은 정의되지 않습니다.

(C++11부터)
5) 범위 [ first , last ) 의 내용으로 vector 를 생성합니다. [ first , last ) 내의 각 반복자는 정확히 한 번 역참조됩니다.

만약 InputIt 가 LegacyInputIterator 요구사항을 만족하지 않으면, 대신 인자 static_cast < size_type > ( first ) , last 및 alloc 를 사용하여 오버로드 (4) 가 호출됩니다.

(C++11 이전)

이 오버로드는 InputIt 가 LegacyInputIterator 요구사항을 만족할 때만 오버로드 해결에 참여합니다.

다음 조건 중 하나라도 만족되면 동작은 정의되지 않습니다:

(C++11 이후)
6) 범위 rg 의 내용으로 vector 를 생성합니다. rg 내의 각 반복자는 정확히 한 번 역참조됩니다.
다음 조건 중 하나라도 만족되면, 동작은 정의되지 않습니다:
7) 복사 생성자. vector 를 other 의 내용으로 생성합니다.

할당자는 마치
std:: allocator_traits < Allocator > :: select_on_container_copy_construction
( other. get_allocator ( ) ) 를 호출하는 것처럼 얻어집니다.

(C++11부터)
8) 이동 생성자. vector 를 other 의 내용으로 생성합니다. 할당자는 other. get_allocator ( ) 에서 이동 생성으로 얻습니다.
9) 복사 생성자와 동일하지만, alloc 가 할당자로 사용된다는 점이 다릅니다.
만약 T 가 CopyInsertable 하지 않다면, vector 에 대한 동작은 정의되지 않습니다.
10) 이동 생성자와 동일하지만, alloc 가 할당자로 사용된다는 점이 다릅니다.
만약 T 가 MoveInsertable 가 vector 에 대해 아니라면, 동작은 정의되지 않습니다.
11) 다음과 동일함: vector ( il. begin ( ) , il. end ( ) , alloc ) .

목차

매개변수

alloc - 이 컨테이너의 모든 메모리 할당에 사용할 할당자
count - 컨테이너의 크기
value - 컨테이너 요소 초기화에 사용할 값
first, last - 요소를 복사할 범위 를 정의하는 반복자 쌍
other - 컨테이너 요소 초기화에 사용할 소스 컨테이너
init - 컨테이너 요소 초기화에 사용할 초기화 리스트
rg - 컨테이너 호환 범위

복잡도

1,2) 상수.
3,4) count 에 대해 선형적입니다.
5) 주어진 std:: distance ( first, last ) 를 N 로 가정:
  • T 의 복사 생성자는 N 번만 호출됩니다.
  • 재할당이 발생하지 않습니다.
  • 그렇지 않은 경우:
  • T 의 복사 생성자는 O(N) 번 호출됩니다.
  • 재할당이 O(log N) 번 발생합니다.
6) 주어진 ranges:: distance ( rg ) 를 N 으로:
(C++26 이전)
  • 만약 R 이 다음 조건 중 하나를 만족하면:
그러면:
(C++26 이후)
  • rg 의 연속적인 반복자를 역참조한 결과로부터 정확히 N 개의 요소를 초기화합니다.
  • 재할당이 발생하지 않습니다.
  • 그렇지 않으면:
  • T 의 복사 또는 이동 생성자가 O(N) 번 호출됩니다.
  • 재할당이 O(log N) 번 발생합니다.
7) other. size ( ) 에 선형적입니다.
8) 상수.
9) other. size ( ) 에 선형적입니다.
10) other. size ( ) 에 대해 선형 시간, alloc ! = other. get_allocator ( ) 인 경우, 그렇지 않으면 상수 시간.
11) 선형적으로 init. size ( ) .

예외

Allocator :: allocate 호출은 예외를 발생시킬 수 있습니다.

참고 사항

컨테이너 이동 생성 후 (오버로드 ( 8 ) ), other 에 대한 참조, 포인터 및 반복자(끝 반복자 제외)는 유효하게 유지되지만, 이제는 * this 에 있는 요소들을 참조합니다. 현재 표준은 [container.reqmts]/67 의 포괄적 명시를 통해 이 보장을 제공하며, LWG issue 2321 를 통해 더 직접적인 보장이 검토 중에 있습니다.

기능 테스트 매크로 값 표준 기능
__cpp_lib_containers_ranges 202202L (C++23) Ranges-aware 생성 및 삽입; 오버로드 ( 6 )
__cpp_lib_ranges_reserve_hint 202502L (C++26) ranges::approximately_sized_range 및 ranges::reserve_hint ; 오버로드 ( 6 )

예제

이 코드 실행 
#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 초기화 리스트 구문:
    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는 {"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); // 오버로드 (6)
#else
    std::vector<std::string> words5(rg.begin(), rg.end()); // 오버로드 (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++ 표준에 소급 적용되었습니다.

DR 적용 대상 게시된 동작 수정된 동작
LWG 134 C++98 오버로드 ( 5 ) 에서 입력 반복자 경우 최대 2N 회의 복사
생성자 호출이 허용됨 		O(N) 회의 호출로 변경
LWG 438 C++98 오버로드 ( 5 ) 는 InputIt 이 정수형일 때만
오버로드 ( 4 ) 를 호출함 		InputIt 이 LegacyInputIterator 가 아닐 때
오버로드 ( 4 ) 를 호출함
LWG 2193 C++11 기본 생성자가 explicit였음 non-explicit로 변경
LWG 2210 C++11 오버로드 ( 3 ) 에 할당자 매개변수가 없었음 매개변수 추가
N3346 C++11 오버로드 ( 3 ) 에서 컨테이너 내 요소들이
값 초기화됨 		기본 삽입됨

참고 항목

컨테이너에 값을 할당합니다
(public member function)
컨테이너에 값을 할당합니다
(public member function)