std::basic_string<CharT,Traits,Allocator>:: append_range
From cppreference.net
<
cpp
|
string
|
basic string
C++
Strings library
| Classes | ||||
|
(C++17)
|
||||
std::basic_string
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
template
<
container-compatible-range
<
CharT
>
R
>
constexpr std:: basic_string & append_range ( R && rg ) ; |
(C++23부터) | |
범위 rg 에 있는 모든 문자를 추가합니다.
다음과 동일함
return append(std::basic_string( std::from_range, std::forward<R>(rg), get_allocator()));
목차 |
매개변수
| rg | - | a container compatible range |
반환값
* this
복잡도
크기에 선형적으로 비례하는 rg .
예외
만약 연산으로 인해
size()
가
max_size()
를 초과하게 될 경우,
std::length_error
를 발생시킵니다.
어떤 이유로든 예외가 발생하면, 이 함수는 아무런 효과를 가지지 않습니다( strong exception safety guarantee ).
참고 사항
| 기능 테스트 매크로 | 값 | 표준 | 기능 |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | 컨테이너 호환 범위 를 허용하는 멤버 함수 |
예제
이 코드 실행
#include <cassert> #include <string> int main() { std::string head{"long long"}; const auto tail = {' ', 'i', 'n', 't'}; #ifdef __cpp_lib_containers_ranges head.append_range(tail); #else head.append(tail.begin(), tail.end()); #endif assert(head == "long long int"); }
참고 항목
|
끝에 문자들을 추가함
(public member function) |