C++ 字串庫 - insert

描述

它在 pos 指示的字元之前插入額外的字元到字串中。

宣告

以下是 std::string::insert 的宣告。

string& insert (size_t pos, const string& str);

C++11

string& insert (size_t pos, const string& str);

C++14

string& insert (size_t pos, const string& str);

引數

• pos − 插入點。

• str − 字串物件。

返回值

它返回 *this。

異常

如果丟擲異常，字串不會發生任何變化。

示例

以下示例演示了 std::string::insert 的用法。

#include <cassert>
#include <iterator>
#include <string>
using namespace std::literals;
int main() {
   std::string s = "xmplr";

   s.insert(0, 1, 'E');
   assert("Exmplr" == s);

   s.insert(2, "e");
   assert("Exemplr" == s);

   s.insert(6, "a"s);
   assert("Exemplar" == s);

   s.insert(8, " is an example string."s, 0, 14);
   assert("Exemplar is an example" == s);

   s.insert(s.cbegin() + s.find_first_of('n') + 1, ':');
   assert("Exemplar is an: example" == s);
 
   s.insert(s.cbegin() + s.find_first_of(':') + 1, 2, '=');
   assert("Exemplar is an:== example" == s);
   {
      std::string seq = " string";
      s.insert(s.begin() + s.find_last_of('e') + 1,
      std::begin(seq), std::end(seq));
      assert("Exemplar is an:== example string" == s);
   }

   s.insert(s.cbegin() + s.find_first_of('g') + 1, { '.' });
   assert("Exemplar is an:== example string." == s);
}