Namespaces
Variants

std::basic_string_view<CharT,Traits>:: basic_string_view

From 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) 要素 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 と等しい。

このオーバーロードは、以下の条件がすべて満たされる場合にのみオーバーロード解決に参加する:

6) 範囲 r に対する std::basic_string_view を構築します。構築後、 data() ranges:: data ( r ) と等しく、 size() ranges:: size ( 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> の公開メンバ関数)