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

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string_view

メンバ関数 basic_string_view::basic_string_view basic_string_view::operator= イテレータ basic_string_view::beginbasic_string_view::cbegin basic_string_view::endbasic_string_view::cend basic_string_view::rbeginbasic_string_view::crbegin basic_string_view::rendbasic_string_view::crend 要素アクセス basic_string_view::at basic_string_view::operator[] basic_string_view::front basic_string_view::back basic_string_view::data 容量 basic_string_view::sizebasic_string_view::length basic_string_view::max_size basic_string_view::empty 変更 basic_string_view::remove_prefix basic_string_view::remove_suffix basic_string_view::swap

操作 basic_string_view::copy basic_string_view::substr basic_string_view::compare basic_string_view::starts_with (C++20) basic_string_view::ends_with (C++20) basic_string_view::find basic_string_view::rfind basic_string_view::find_first_of basic_string_view::find_last_of basic_string_view::find_first_not_of basic_string_view::find_last_not_of 定数 basic_string_view::npos 非メンバ関数 operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20) operator<< operator""sv ヘルパークラス hash<std::string_view>hash<std::wstring_view>hash<std::u8string_view>hash<std::u16string_view>hash<std::u32string_view> (C++20) 推定ガイド(C++20)

 

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以上)

1) デフォルトコンストラクタ。 空の 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) に対する 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 に変換可能でない

場合にのみ、オーバーロード解決に参加します。

引数

other	-	ビューを初期化する別のビュー
s	-	ビューを初期化する文字配列または C の文字列を指すポインタ
count	-	ビューに含める文字数
first	-	シーケンスの最初の文字を指すイテレータ
last	-	シーケンスの最後の文字の次のイテレータまたは別の番兵

計算量

1-3,5) 一定。

4) s の長さに比例。

例

Run this code

#include <iostream>
#include <string>
#include <string_view>
int main()
{
    std::wstring_view wcstr_v = L"xyzzy";
 
    char array[3] = {'B', 'a', 'r'};
    std::string_view array_v(array, std::size(array));
 
    std::string cppstr = "Foo";
    std::string_view cppstr_v(cppstr); 
 
    std::cout << cppstr_v << '\n'
              << array_v << '\n'
              << wcstr_v.size() << '\n';
}

出力:

Foo
Bar
5

関連項目

operator=

ビューを代入します (パブリックメンバ関数)