std::basic_string_view

ヘッダ `<string_view>` で定義
template< class CharT, class Traits = std::char_traits<CharT> > class basic_string_view;		(C++17以降)

クラステンプレートbasic_string_viewは、先頭要素が位置0にある、CharTの定数で連続したシーケンスを参照できるオブジェクトを記述します。

basic_string_view strに対して、範囲[str.data(), str.data() + str.size())内のポインタを無効にする操作が行われた場合、strの要素へのポインタ、イテレータ、および参照は無効になります。

std::basic_string_viewの全ての特殊化は、TriviallyCopyable型です。

(C++23から)

典型的な実装では、定数CharTへのポインタとサイズという2つのメンバのみを保持します。

一般的な文字型のためにいくつかの typedef が提供されています

ヘッダ `<string_view>` で定義
型	定義
std::string_view (C++17)	std::basic_string_view<char>
std::wstring_view (C++17)	std::basic_string_view<wchar_t>
std::u8string_view (C++20)	std::basic_string_view<char8_t>
std::u16string_view (C++17)	std::basic_string_view<char16_t>
std::u32string_view (C++17)	std::basic_string_view<char32_t>

[編集] テンプレートパラメータ

CharT	-	文字型
Traits	-	文字型に対する操作を指定するCharTraitsクラス。std::basic_stringと同様に、`Traits::char_type`は`CharT`と同じ型でなければならず、そうでなければプログラムは不適格となります。

[編集] メンバ型

ネストされた型定義

traits_type Traits

value_type CharT

pointer CharT*

const_pointer const CharT*

reference CharT&

const_reference const CharT&

const_iterator

実装定義の定数LegacyRandomAccessIterator、

かつLegacyContiguousIterator	(C++20まで)
ConstexprIterator、および`contiguous_iterator`	(C++20以降)

そのvalue_typeはCharT

iterator const_iterator

const_reverse_iterator std::reverse_iterator<const_iterator>

reverse_iterator const_reverse_iterator

size_type std::size_t

difference_type std::ptrdiff_t

注：string viewは定数文字シーケンスへのビューであるため、iteratorとconst_iteratorは同じ型です。

コンテナのイテレータ型に対する全ての要件は、basic_string_viewのiteratorおよびconst_iterator型にも同様に適用されます。

[編集] メンバ関数

コンストラクタと代入
(コンストラクタ)	`basic_string_view`を構築する (public member function) [編集]
operator=	ビューを代入する (public member function) [編集]
イテレータ
begincbegin	先頭へのイテレータを返す (public member function) [編集]
endcend	末尾へのイテレータを返す (public member function) [編集]
rbegincrbegin	先頭への逆イテレータを返す (public member function) [編集]
rendcrend	末尾への逆イテレータを返す (public member function) [編集]
要素アクセス
operator[]	指定された文字にアクセスする (public member function) [編集]
at	境界チェック付きで指定された文字にアクセスする (public member function) [編集]
front	最初の文字にアクセスする (public member function) [編集]
back	最後の文字にアクセスする (public member function) [編集]
data	ビューの最初の文字へのポインタを返す (public member function) [編集]
容量
sizelength	文字数を返す (public member function) [編集]
max_size	最大文字数を返す (public member function) [編集]
empty	ビューが空かどうかをチェックする (public member function) [編集]
変更
remove_prefix	ビューの開始位置を前方に移動して縮小する (public member function) [編集]
remove_suffix	ビューの終了位置を後方に移動して縮小する (public member function) [編集]
swap	内容を交換する (public member function) [編集]
操作
copy	文字をコピーする (public member function) [編集]
substr	部分文字列を返す (public member function) [編集]
compare	2つのビューを比較する (public member function) [編集]
starts_with (C++20)	string viewが指定されたプレフィックスで始まるかチェックする (public member function) [編集]
ends_with (C++20)	string viewが指定されたサフィックスで終わるかチェックする (public member function) [編集]
contains (C++23)	string viewが指定された部分文字列または文字を含むかチェックする (public member function) [編集]
find	ビュー内の文字を検索する (public member function) [編集]
rfind	部分文字列が最後に現れる位置を見つける (public member function) [編集]
find_first_of	文字が最初に現れる位置を見つける (public member function) [編集]
find_last_of	文字が最後に現れる位置を見つける (public member function) [編集]
find_first_not_of	文字が最初に現れない位置を見つける (public member function) [編集]
find_last_not_of	文字が最後に現れない位置を見つける (public member function) [編集]
定数
npos [static]	特別な値。正確な意味は文脈に依存する (public static member constant) [編集]

[編集] 非メンバ関数

operator==operator!=operator<operator>operator<=operator>=operator<=> (C++17)(C++20で削除)(C++20で削除)(C++20で削除)(C++20で削除)(C++20で削除)(C++20)	2つのstring viewを辞書順で比較する (function template) [編集]
入出力
operator<< (C++17)	string viewのストリーム出力を行う (function template) [編集]

[編集] リテラル

インライン名前空間`std::literals::string_view_literals`で定義
operator""sv (C++17)	文字配列リテラルのstring viewを作成する (function) [編集]

[編集] ヘルパークラス

std::hash<std::string_view>std::hash<std::wstring_view>std::hash<std::u8string_view>std::hash<std::u16string_view>std::hash<std::u32string_view>

(C++17)(C++17)(C++20)(C++17)(C++17)

文字列ビューのハッシュサポート
(クラステンプレートの特殊化) [編集]

[編集] ヘルパーテンプレート

template< class CharT, class Traits > inline constexpr bool ranges::enable_borrowed_range<std::basic_string_view<CharT, Traits>> = true;		(C++20以降)

このranges::enable_borrowed_rangeの特殊化により、basic_string_viewはborrowed_rangeを満たします。

template< class CharT, class Traits > inline constexpr bool ranges::enable_view<std::basic_string_view<CharT, Traits>> = true;		(C++20以降)

このranges::enable_viewの特殊化により、basic_string_viewはviewを満たします。

推論補助

(C++20以降)

[編集] ノート

std::string_viewが、指し示している文字配列より長生きしないようにするのはプログラマの責任です。

std::string_view good{"a string literal"};
    // "Good" case: `good` points to a static array.
    // String literals reside in persistent data storage.
 
std::string_view bad{"a temporary string"s};
    // "Bad" case: `bad` holds a dangling pointer since the std::string temporary,
    // created by std::operator""s, will be destroyed at the end of the statement.

std::basic_string_viewの特殊化は、C++23で正式な要件が導入される前から、既存の全ての実装において既にtrivially copyableな型です。

機能テストマクロ	値	規格	機能
`__cpp_lib_string_view`	`201606L`	(C++17)	`std::string_view`
`__cpp_lib_string_view`	`201803L`	(C++20)	ConstexprIterator
`__cpp_lib_string_contains`	`202011L`	(C++23)	`contains`

[編集] 例

このコードを実行

#include <iostream>
#include <string_view>
 
int main()
{
    constexpr std::string_view unicode[]{"▀▄─", "▄▀─", "▀─▄", "▄─▀"};
 
    for (int y{}, p{}; y != 6; ++y, p = ((p + 1) % 4))
    {
        for (int x{}; x != 16; ++x)
            std::cout << unicode[p];
        std::cout << '\n';
    }
}

出力

▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─
▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─
▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄
▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀
▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─
▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─

[編集] 欠陥報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 3203	C++17	のメンバ関数から返されたポインタ、イテレータ、および参照のみが `basic_string_view`無効になる可能性がある	の要素への全てのポインタ、イテレータ、および参照が `basic_string_view`無効になる可能性がある

[編集] 関連項目

basic_string	文字のシーケンスを格納し操作する (クラステンプレート) [編集]
operator+	2つの文字列、文字列とchar、または文字列とstring_viewを連結する (function template) [編集]
span (C++20)	連続したオブジェクトのシーケンスに対する所有権を持たないビュー (class template) [編集]
initializer_list (C++11)	リスト初期化で作成された一時配列を参照する (クラステンプレート) [編集]

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作