std::basic_string<CharT,Traits,Allocator>:: basic_string

様々なデータソースから新しい文字列を構築し、オプションでユーザー提供のアロケータ alloc を使用します。

パラメータ

計算量

例外

構築される文字列の長さが std::length_error をスローする（例えば max_size() を超える場合（ count > max_size ( ) が (3) の場合）。 Allocator::allocate の呼び出しは例外をスローする可能性がある。

何らかの理由で例外がスローされた場合、これらの関数は何も効果を持ちません（ strong exception safety guarantee ）。

注記

埋め込まれた ' \0 ' 文字を含む string literal による初期化は、最初のnull文字で停止するオーバーロード (7) を使用します。これは、異なるコンストラクタを指定するか、 operator""s を使用することで回避できます：

std::string s1 = "ab\0\0cd";   // s1は"ab"を含む
std::string s2{"ab\0\0cd", 6}; // s2は"ab\0\0cd"を含む
std::string s3 = "ab\0\0cd"s;  // s3は"ab\0\0cd"を含む

例

#include <cassert>
#include <cctype>
#include <iomanip>
#include <iostream>
#include <iterator>
#include <string>
int main()
{
    std::cout << "1)  string(); ";
    std::string s1;
    assert(s1.empty() && (s1.length() == 0) && (s1.size() == 0));
    std::cout << "s1.capacity(): " << s1.capacity() << '\n'; // 未指定
    std::cout << "3)  string(size_type count, CharT ch): ";
    std::string s2(4, '=');
    std::cout << std::quoted(s2) << '\n'; // "===="
    std::cout << "4)  string(InputIt first, InputIt last): ";
    char mutable_c_str[] = "別のCスタイル文字列";
    std::string s4(std::begin(mutable_c_str) + 8, std::end(mutable_c_str) - 1);
    std::cout << std::quoted(s4) << '\n'; // "C-style string"
    std::cout << "6)  string(CharT const* s, size_type count): ";
    std::string s6("C-style string", 7);
    std::cout << std::quoted(s6) << '\n'; // "Cスタイル"、すなわち [0, 7)
    std::cout << "7)  string(CharT const* s): ";
    std::string s7("Cスタイル\0文字列");
    std::cout << std::quoted(s7) << '\n'; // "C-style"
    std::cout << "11) string(string&): ";
    std::string const other11("模範");
    std::string s11(other11);
    std::cout << std::quoted(s11) << '\n'; // "Exemplar"
    std::cout << "12) string(string&&): ";
    std::string s12(std::string("C++ by ") + std::string("example"));
    std::cout << std::quoted(s12) << '\n'; // "C++ by example"
    std::cout << "15) string(const string& other, size_type pos): ";
    std::string const other15("Mutatis Mutandis");
    std::string s15(other15, 8);
    std::cout << std::quoted(s15) << '\n'; // "Mutandis"、すなわち [8, 16)
    std::cout << "17) string(const string& other, size_type pos, size_type count): ";
    std::string const other17("模範的");
    std::string s17(other17, 0, other17.length() - 1);
    std::cout << std::quoted(s17) << '\n'; // "Exemplar"
    std::cout << "19) string(std::initializer_list<CharT>): ";
    std::string s19({'C', '-', 's', 't', 'y', 'l', 'e'});
    std::cout << std::quoted(s19) << '\n'; // "C-style"
}

1)  string(); s1.capacity(): 15
3)  string(size_type count, CharT ch): "===="
4)  string(InputIt first, InputIt last): "C-style string"
6)  string(CharT const* s, size_type count): "C-style"
7)  string(CharT const* s): "C-style"
11) string(string&): "Exemplar"
12) string(string&&): "C++ by example"
15) string(const string& other, size_type pos): "Mutandis"
17) string(const string& other, size_type pos, size_type count): "Exemplar"
19) string(std::initializer_list<CharT>): "C-style"

不具合報告

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

1. ↑ [ nullptr , nullptr + 0 ) は有効な空範囲です。なぜなら、nullポインタ値にゼロを加えることも 明確に定義されている からです（結果は依然としてnullポインタ値となります）。

関連項目