모두의 코드
C++ 레퍼런스 - string 의 insert 함수

insert

insert 함수는 문자열의 중간에 문자를 추가해주는 함수로, 편의를 위해 여러가지 형태의 함수들을 제공하고 있습니다.

basic_string& insert(size_type index, size_type count, CharT ch);
basic_string& insert(size_type index, const CharT* s);
basic_string& insert(size_type index, const CharT* s, size_type count);
basic_string& insert(size_type index, const basic_string& str);
basic_string& insert(size_type index, const basic_string& str,
                     size_type index_str, size_type count = npos);

index 위치에 문자 혹은 문자열을 삽입한다. 인자로 CharT 를 받는 경우, 해당 문자를 count 개 만큼 삽입합니다. 인자로 const CharT*const basic_string& 을 받는 경우 전달되는 문자열 (포인터의 경우 NULL 종료 문자열이라 생각) 을 index 위치에 삽입합니다.

참고로 index 위치에 집어넣는다는 뜻은, 삽입되는 문자열의 시작 위치가 index 번째가 된다는 뜻입니다. 즉, 기존에 index 위치에 있던 문자는 삽입되는 문자열 맨 뒤로 밀리게 됩니다.

iterator insert(const_iterator pos, CharT ch);
iterator insert(const_iterator pos, size_type count, CharT ch);

반복자 pos 가 가리키는 위치에 문자 ch 를 삽입합니다. count 를 지정하는 경우, count 개 만큼의 문자들을 삽입합니다.

template <class InputIt>
iterator insert(const_iterator pos, InputIt first, InputIt last);

반복자 pos 가 가리키는 위치에 first 부터 last 전 까지의 문자열을 삽입합니다.

iterator insert(const_iterator pos, std::initializer_list<CharT> ilist);

반복자 pos 가 가리키는 위치에, 초기화자 ilist 의 문자들을 삽입합니다.

template <class T>
basic_string& insert(size_type pos, const T& t);
template <class T>
basic_string& insert(size_type index, const T& t, size_type index_str,
                     size_type count = npos);

t 를 string_view sv 로 변한한 뒤에 pos 가 가리키는 위치에 sv 의 원소들을 삽입합니다. 이는 마치,

std::basic_string_view<CharT, Traits> sv = t;
insert(pos, sv.data(), sv.size())

와 동일하다고 볼 수 있습니다. 참고로 이를 위해서, 타입 T 가 basic_string_view 로 변환 가능한 타입이어야 합니다. 두 번째 경우도 위와 동일하지만, sv 전체 문자열이 아닌, index_str 부터 끝까지의 문자들을 삽입합니다.

인자

리턴값

반복자를 사용하지 않는 경우, 삽입된 문자열이 리턴되고, 반복자를 사용하는 경우, 삽입된 위치를 가리키는 반복자를 리턴한다.

참고적으로, 문자열을 삽입하는 위치가 문자열 범위를 벗어난다면 std::out_of_range 예외를 발생시킨다. 만약에, 문자열을 삽입하는 위치는 정상적이지만, 삽입되는 문자열이 너무 길다면 (C++ 문자열의 최대 길이는 str.max_size() 로 정의됨) std::lengtherror

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

  // insert(size_type index, size_type count, char ch)
  s.insert(0, 1, 'E');
  assert("Exmplr" == s);

  // insert(size_type index, const char* s)
  s.insert(2, "e");
  assert("Exemplr" == s);

  // insert(size_type index, string const& str)
  s.insert(6, "a"s);
  assert("Exemplar" == s);

  // insert(size_type index, string const& str,
  //     size_type index_str, size_type count)
  s.insert(8, " is an example string."s, 0, 14);
  assert("Exemplar is an example" == s);

  // insert(const_iterator pos, char ch)
  s.insert(s.cbegin() + s.find_first_of('n') + 1, ':');
  assert("Exemplar is an: example" == s);

  // insert(const_iterator pos, size_type count, char ch)
  s.insert(s.cbegin() + s.find_first_of(':') + 1, 2, '=');
  assert("Exemplar is an:== example" == s);

  // insert(const_iterator pos, InputIt first, InputIt last)
  {
    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);
  }

  // insert(const_iterator pos, std::initializer_list<char>)
  s.insert(s.cbegin() + s.find_first_of('g') + 1, {'.'});
  assert("Exemplar is an:== example string." == s);
}

assert 문을 확인하면 결과를 알 수 있다.

연관된 함수

프로필 사진 없음
댓글에 글쓴이에게 큰 힘이 됩니다