std::list<T,Allocator>:: append_range
|
template
<
container-compatible-range
<
T
>
R
>
void append_range ( R && rg ) ; |
(C++23부터)
(C++26부터 constexpr) |
|
rg
범위의 요소들을 비역순(non-reversing)으로
end()
앞에 복사본을 삽입합니다.
반복자나 참조가 무효화되지 않습니다.
rg 내의 각 반복자는 정확히 한 번 역참조됩니다.
목차 |
매개변수
| rg | - |
a
container compatible range
, that is, an
input_range
whose elements are convertible to
T
|
| 타입 요구사항 | ||
-
T
가
EmplaceConstructible
하지 않으면
list
에
*
ranges::
begin
(
rg
)
에서, 동작은 정의되지 않습니다.
|
||
복잡도
rg
의 크기에 선형적입니다.
T
의 생성자 호출 횟수는 정확히
std
::
ranges::
size
(
rg
)
)
와 동일합니다.
예외
어떤 이유로든 예외가 발생하면, 이 함수는 아무런 효과를 가지지 않습니다( strong exception safety guarantee ).
참고 사항
| 기능 테스트 매크로 | 값 | 표준 | 기능 |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | 레인지 인식 생성 및 삽입 |
예제
#include <cassert> #include <list> #include <vector> int main() { auto head = std::list{1, 2, 3, 4}; const auto tail = std::vector{-5, -6, -7}; #ifdef __cpp_lib_containers_ranges head.append_range(tail); #else head.insert(head.end(), tail.cbegin(), tail.cend()); #endif assert((head == std::list{1, 2, 3, 4, -5, -6, -7})); }
참고 항목
|
(C++23)
|
시작 부분에 요소 범위를 추가함
(public member function) |
|
(C++23)
|
요소 범위를 삽입함
(public member function) |
|
끝에 요소를 추가함
(public member function) |
|
|
(C++11)
|
끝에 제자리에서 요소를 생성함
(public member function) |