std::basic_string_view<CharT,Traits>::basic_string_view
cppreference.net에서 가져옴
constexpr basic_string_view() noexcept;
|
(1) | (C++17부터) |
constexpr basic_string_view( const basic_string_view& other ) noexcept = default;
|
(2) | (C++17부터) |
constexpr basic_string_view( const CharT* s, size_type count );
|
(3) | (C++17부터) |
constexpr basic_string_view( const CharT* s );
|
(4) | (C++17부터) |
template< class It, class End >
constexpr basic_string_view( It first, End last );
|
(5) | (C++20부터) |
template< class R >
constexpr explicit basic_string_view( R&& r );
|
(6) | (C++23부터) |
basic_string_view( std::nullptr_t ) = delete;
|
(7) | (C++23부터) |
1) 기본 생성자. 빈
std::basic_string_view을 생성합니다. 생성 후 data()는 nullptr과 같고 size()는 0와 같습니다.2) 복사 생성자.
other와 동일한 내용의 뷰를 생성합니다. 생성 후 data()는 other.data()과 같고 size()는 other.size()와 같습니다.3)
count이 가리키는 요소로 시작하는 문자 배열의 처음 s개의 문자에 대한 뷰를 생성합니다. s는 널 문자를 포함할 수 있습니다. [s, s + count)이 유효한 범위가 아닌 경우 동작은 정의되지 않습니다 (생성자가 이 범위의 요소에 접근하지 않을 수 있지만). 생성 후 data()는 s과 같고 size()는 count와 같습니다.4)
s이 가리키는 널 종료 문자 문자열의 뷰를 생성합니다. 종료 널 문자는 포함하지 않습니다. 뷰의 길이는 Traits::length(s)에 의해 결정됩니다. [s, s + Traits::length(s))이 유효한 범위가 아닌 경우 동작은 정의되지 않습니다. 생성 후 data()는 s과 같고 size()는 Traits::length(s)와 같습니다.5) 범위
std::basic_string_view에 대한 [first, last)을 생성합니다. [first, last)이 유효한 범위가 아닌 경우, It이 실제로 contiguous_iterator를 모델링하지 않는 경우, 또는 End이 실제로 sized_sentinel_for for It를 모델링하지 않는 경우 동작은 정의되지 않습니다. 생성 후 data()는 std::to_address(first)과 같고 size()는 last - first와 같습니다.
이 오버로드는 다음 조건을 모두 만족하는 경우에만 오버로드 해석에 참여합니다:
It가 contiguous_iterator을 만족하고,End가 sized_sentinel_for forIt을 만족하고,std::iter_value_t<It>와CharT는 동일한 타입이며,End이 std::size_t로 변환 가능하지 않습니다.
6) 범위
std::basic_string_view에 대한 r을 생성합니다. 생성 후 data()는 ranges::data(r)과 같고 size()는 ranges::size(r)와 같습니다.
이 오버로드는 다음 조건을 모두 만족하는 경우에만 오버로드 해석에 참여합니다:
std::remove_cvref_t<R>이std::basic_string_view과 동일한 타입이 아니고,R가 contiguous_range 및 sized_range을 모델링하고,ranges::range_value_t<R>와CharT는 동일한 타입이며,R이const CharT*로 변환 가능하지 않고,d를std::remove_cvref_t<R>타입의 lvalue라고 할 때,d.operator ::std::basic_string_view<CharT, Traits>()는 유효한 표현식이 아닙니다.
7)
std::basic_string_view을 nullptr로부터 생성할 수 없습니다.매개변수
| other | - | 뷰를 초기화할 다른 뷰 |
| s | - | 뷰를 초기화할 문자 배열 또는 C 문자열에 대한 포인터 |
| count | - | 뷰에 포함할 문자 수 |
| first | - | 시퀀스의 첫 번째 문자를 가리키는 반복자 |
| last | - | 시퀀스의 마지막 문자 다음을 가리키는 반복자 또는 다른 센티넬 |
| r | - | 시퀀스를 포함하는 연속 범위 |
복잡도
1-3,5,6)
상수.
4)
길이에 대해 선형적인
s
.
예제
이 코드 실행
#include <array> #include <iomanip> #include <iostream> #include <string> #include <string_view> int main() { std::string cppstr = "Foo"; std::string_view cppstr_v(cppstr); // 오버로드 (2), 이후 // std::string::operator string_view std::cout << "1) cppstr_v: " << std::quoted(cppstr_v) << '\n'; char array[3] = {'B', 'a', 'r'}; std::string_view array_v(array, std::size(array)); // 오버로드 (3) std::cout << "2) array_v: " << std::quoted(array_v) << '\n'; const char* one_0_two = "One\0Two"; std::string_view one_two_v{one_0_two, 7}; // 오버로드 (3) std::cout << "3) one_two_v: \""; for (char c : one_two_v) std::cout << (c != '\0' ? c : '?'); std::cout << "\", one_two_v.size(): " << one_two_v.size() << '\n'; std::string_view one_v{one_0_two}; // 오버로드 (4) std::cout << "4) one_v: " << std::quoted(one_v) << ", one_v.size(): " << one_v.size() << '\n'; constexpr std::wstring_view wcstr_v = L"xyzzy"; // 오버로드 (4) std::cout << "5) wcstr_v.size(): " << wcstr_v.size() << '\n'; std::array ar = {'P', 'u', 'b'}; std::string_view ar_v(ar.begin(), ar.end()); // 오버로드 (5), C++20 std::cout << "6) ar_v: " << std::quoted(ar_v) << '\n'; // std::string_view ar_v2{ar}; // 오버로드 (6), C++23에서 OK // std::cout << "ar_v2: " << std::quoted(ar_v2) << '\n'; // ar_v2: "Pub" [[maybe_unused]] auto zero = [] { /* ... */ return nullptr; }; // std::string_view s{zero()}; // 오버로드 (7), C++23부터 컴파일되지 않음 }
출력:
1) cppstr_v: "Foo" 2) array_v: "Bar" 3) one_two_v: "One?Two", one_two_v.size(): 7 4) one_v: "One", one_v.size(): 3 5) wcstr_v.size(): 5 6) ar_v: "Pub"
참고 항목
|
뷰를 할당함
(public member function) |
|
basic_string
을 생성함
(
std::basic_string<CharT,Traits,Allocator>
의 public member function)
|