std::basic_string_view<CharT,Traits>:: basic_string_view
From cppreference.net
<
cpp
|
string
|
basic string view
|
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以降) |
2)
コピーコンストラクタ。
other
と同じ内容のビューを構築する。構築後、
data()
は
other.
data
(
)
と等しく、
size()
は
other.
size
(
)
と等しくなる。
3)
要素
s
が指す文字配列の先頭から
count
文字分のビューを構築する。
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)
範囲
[
first
,
last
)
上に
std::basic_string_view
を構築する。
[
first
,
last
)
が有効な範囲でない場合、
It
が実際に
contiguous_iterator
をモデル化していない場合、または
End
が実際に
It
に対する
sized_sentinel_for
をモデル化していない場合、動作は未定義である。構築後、
data()
は
std::
to_address
(
first
)
と等しく、
size()
は
last
-
first
と等しい。
このオーバーロードは、以下の条件がすべて満たされる場合にのみオーバーロード解決に参加する:
-
-
Itがcontiguous_iteratorを満たすこと、 -
EndがItに対するsized_sentinel_forを満たすこと、 -
std::
iter_value_t
<
It
>
と
CharTが同じ型であること、および -
Endが std::size_t に変換可能でないこと。
-
6)
範囲
r
に対する
std::basic_string_view
を構築します。構築後、
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 > の左辺値としたとき、 d. operator :: std:: basic_string_view < CharT, Traits > ( ) が有効な式でないこと
-
std::
remove_cvref_t
<
R
>
が
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"
関連項目
|
ビューを代入する
(公開メンバ関数) |
|
basic_string
を構築する
(
std::basic_string<CharT,Traits,Allocator>
の公開メンバ関数)
|