std::basic_string

template<
    class CharT,
    class Traits = std::char_traits<CharT>,
    class Allocator = std::allocator<CharT>
> class basic_string;

namespace pmr {
template<
    class CharT,
    class Traits = std::char_traits<CharT>
> using basic_string =
    std::basic_string<CharT, Traits, std::pmr::polymorphic_allocator<CharT>>;
}

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

basic_string の要素は連続して格納されます。つまり、basic_string s に対して、&*(s.begin() + n) == &*s.begin() + n 内の任意の n について [0, s.size()) が成り立ち、*(s.begin() + s.size()) の値は CharT()（ヌル終端文字）となります(C++11 以上); または同等に、s[0] へのポインタは、配列(C++11 未満)ヌル終端配列(C++11 以上) の最初の要素へのポインタを期待する関数に渡すことができます。 CharT

std::basic_string は、AllocatorAwareContainer（カスタマイズされた construct/destroy が要素の構築/破棄に使用されないことを除く）、SequenceContainer、および ContiguousContainer(C++17 以上) の要件を満たします。

もし Traits::char_type と Allocator::char_type のいずれかが CharT と異なる場合、プログラムは ill-formed となります。

一般的な文字型に対していくつかの 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 で修正されました。

関連項目

外部リンク