std:: basic_string

クラステンプレート basic_string は、 文字 のようなオブジェクトのシーケンスを格納および操作します。これらのオブジェクトは、 TrivialType および StandardLayoutType の非配列オブジェクトです。このクラスは、文字型にもその型に対する操作の性質にも依存しません。操作の定義は、 Traits テンプレートパラメータを通じて提供されます - これは std::char_traits の特殊化、または互換性のある特性クラスです。

basic_string の要素は連続して格納されます。つまり、任意の basic_string s について、 & * ( s. begin ( ) + n ) == & * s. begin ( ) + n が [ ​ 0 ​ , s. size ( ) ) の範囲の任意の n に対して成り立ちます 。また、 * ( s. begin ( ) + s. size ( ) ) の値は CharT ( ) （ナルターミネータ）です (C++11以降) 。言い換えれば、 s [ 0 ] へのポインタは、 配列の先頭要素を指すポインタを期待する関数 (C++11以前) ナル終端配列の先頭要素を指すポインタを期待する関数 (C++11以降) に渡すことができます。

std::basic_string は、 AllocatorAwareContainer の要件を満たします （ただし、要素の構築/破棄にはカスタマイズされた construct / destroy は使用されません）。 SequenceContainer および ContiguousContainer (C++17以降) の要件も満たします。

Traits::char_type と Allocator::value_type のいずれかが CharT と異なる場合、プログラムは不適格です。

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

テンプレートパラメータ

ネストされた型

データメンバ

メンバー関数

非メンバー関数

リテラル

ヘルパークラス

推論ガイド (C++17以降)

イテレータの無効化

basic_string の要素を参照する参照、ポインタ、およびイテレータは、 basic_string への非const参照を引数に取る標準ライブラリ関数（例： std::getline 、 std::swap または operator>> ）によって、および非constメンバ関数の呼び出しによって無効化される可能性があります。ただし、 operator[] 、 at 、 data 、 front 、 back 、 begin 、 rbegin 、 end 、および rend を除きます。

注記

C++23までは std::basic_string の要素を構築・破棄する際にカスタマイズされた construct または destroy を使用することが要求されていましたが、すべての実装はデフォルトのメカニズムのみを使用していました。この要求は P1072R10 によって既存の実装に合わせて修正されました。

例

#include <iostream>
#include <string>
int main()
{
    using namespace std::literals;
    // const char*からの文字列作成
    std::string str1 = "hello";
    // 文字列リテラルを使用した文字列作成
    auto str2 = "world"s;
    // 文字列の連結
    std::string str3 = str1 + " " + str2;
    // 結果の出力
    std::cout << str3 << '\n';
    std::string::size_type pos = str3.find(" ");
    str1 = str3.substr(pos + 1); // スペース以降の部分
    str2 = str3.substr(0, pos);  // スペースまでの部分
    std::cout << str1 << ' ' << str2 << '\n';
    // 添字演算子[]を使用した要素へのアクセス
    std::cout << str1[0] << '\n';
    str1[0] = 'W';
    std::cout << str1 << '\n';
}

hello world
world hello
w
World

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

1. ↑ Traits::char_type のケースは P1148R0 で修正されました。

関連項目

外部リンク