C++のstd::basic_string::assign関数：初心者向けチュートリアル

C++のStringsとstd::basic_string::assign

assign関数の概要

std::basic_string::assign(initializer_list<CharT> il);

この関数は、initializer list を受け取り、その内容を std::string に割り当てます。initializer list は、カンマで区切られた値のリストです。

std::string str;

// initializer list を使って文字列を割り当てる
str.assign({'H', 'e', 'l', 'l', 'o'});

// 出力: "Hello"
std::cout << str << std::endl;

assign関数のパラメータ

assign 関数は、initializer list 以外にも様々なパラメータを受け取ることができます。

• 文字列リテラル:

str.assign("Hello, world!");

• C文字列:

const char* c_str = "Hello, world!";
str.assign(c_str);

• 別のstd::string:

std::string str2 = "Hello, world!";
str.assign(str2);

• 文字の範囲:

std::string str3 = "This is a long string.";
str.assign(str3.begin(), str3.begin() + 5); // 最初の5文字を割り当てる

// 出力: "This "
std::cout << str << std::endl;

assign関数の注意点

• assign 関数は、既存の文字列の内容を置き換えます。
• assign 関数は、新しい文字列の長さに合わせて、std::string の容量を自動的に調整します。
• assign 関数は、std::out_of_range 例外を発生させる可能性があります。これは、割り当てる文字列の長さが std::string の最大容量を超えた場合に発生します。

例

std::string str;

// 文字列リテラルを割り当てる
str.assign("Hello, world!");
std::cout << str << std::endl; // 出力: "Hello, world!"

// C文字列を割り当てる
const char* c_str = "This is a C-string.";
str.assign(c_str);
std::cout << str << std::endl; // 出力: "This is a C-string."

// 別のstd::stringを割り当てる
std::string str2 = "This is another string.";
str.assign(str2);
std::cout << str << std::endl; // 出力: "This is another string."

// 文字の範囲を割り当てる
str.assign(str2.begin(), str2.begin() + 10);
std::cout << str << std::endl; // 出力: "This is an"

std::basic_string::assign は、C++の std::string クラスにおいて、文字列の内容を新しい文字列に置き換えるために使用される重要なメンバー関数です。この関数は、initializer list、文字列リテラル、C文字列、別の std::string、文字の範囲など、様々なパラメータを受け取ることができます。

std::basic_string::assign のサンプルコード

文字列リテラル

std::string str;

// 文字列リテラルを割り当てる
str.assign("Hello, world!");

// 出力: "Hello, world!"
std::cout << str << std::endl;

C文字列

const char* c_str = "This is a C-string.";
str.assign(c_str);

// 出力: "This is a C-string."
std::cout << str << std::endl;

別のstd::string

std::string str2 = "This is another string.";
str.assign(str2);

// 出力: "This is another string."
std::cout << str << std::endl;

文字の範囲

str.assign(str2.begin(), str2.begin() + 10);

// 出力: "This is an"
std::cout << str << std::endl;

initializer list

// initializer list を使って文字列を割り当てる
str.assign({'H', 'e', 'l', 'l', 'o'});

// 出力: "Hello"
std::cout << str << std::endl;

文字と繰り返し数

str.assign(5, 'x');

// 出力: "xxxxx"
std::cout << str << std::endl;

サブ文字列

std::string str3 = "This is a long string.";
str.assign(str3, 8, 10); // 8番目から10番目までの文字を割り当てる

// 出力: "is a"
std::cout << str << std::endl;

イテレータ

std::vector<char> vec = {'H', 'e', 'l', 'l', 'o'};
str.assign(vec.begin(), vec.end());

// 出力: "Hello"
std::cout << str << std::endl;

ヌル文字を含むC文字列

const char* c_str2 = "Hello\0world!";
str.assign(c_str2, strlen(c_str2)); // ヌル文字まで含めて割り当てる

// 出力: "Hello\0world!"
std::cout << str << std::endl;

std::basic_string::assign 以外の文字列の割り当て方法

コンストラクタ

std::string クラスには、様々なコンストラクタが用意されています。

• 文字列リテラルからのコンストラクタ:

std::string str = "Hello, world!";

• C文字列からのコンストラクタ:

const char* c_str = "This is a C-string.";
std::string str(c_str);

• initializer list からのコンストラクタ:

std::string str = {'H', 'e', 'l', 'l', 'o'};

emplace() メンバ関数は、文字列を直接構築するために使用できます。

str.emplace("Hello, world!");

// 出力: "Hello, world!"
std::cout << str << std::endl;

push_back() メンバ関数は、文字列の末尾に 1 文字ずつ追加するために使用できます。

for (char c : "Hello, world!") {
  str.push_back(c);
}

// 出力: "Hello, world!"
std::cout << str << std::endl;

resize() メンバ関数は、文字列の長さを変更するために使用できます。

str.resize(10); // 文字列の長さを10に変更

// 出力: "Hello, wor"
std::cout << str << std::endl;

swap() メンバ関数は、別の std::string オブジェクトと内容を入れ替えるために使用できます。

std::string str2 = "This is another string.";
str.swap(str2);

// 出力: "This is another string."
std::cout << str << std::endl;

std::basic_string::assign は、文字列を割り当てるための便利な方法の一つですが、他にも様々な方法があります。状況に合わせて適切な方法を選択してください。