copy.md

copy

• string_view[meta header]
• std[meta namespace]
• basic_string_view[meta class]
• function[meta id-type]
• cpp17[meta cpp]

size_type copy(CharT* s, size_type n, size_type pos = 0) const;           // C++17

constexpr size_type copy(CharT* s, size_type n, size_type pos = 0) const; // C++20

概要

他の文字列に、自身の文字列をコピーする。

要件

nとsize() - posのうち、小さい方をrlenとする。

• [s, s + rlen)が妥当な範囲であり、その範囲内の要素にアクセスできること

効果

以下と等価の処理を行う：

Traits::copy(s, data() + pos, rlen);

• copy[link /reference/string/char_traits/copy.md]
• data()[link data.md]

戻り値

rlen

例外

pos > size()の場合、std::out_of_range例外を送出する。

例

#include <iostream>
#include <string_view>

int main()
{
  const std::string_view sv = "hello";

  // 全体をコピーする
  {
    char result[5 + 1] = {};
    sv.copy(result, 5);

    std::cout << result << std::endl;
  }

  // 先頭3要素だけコピーする
  {
    char result[3 + 1] = {};
    sv.copy(result, 3);

    std::cout << result << std::endl;
  }

  // 2番目以降の要素をコピーする
  {
    char result[3 + 1] = {};
    sv.copy(result, 3, 2);

    std::cout << result << std::endl;
  }
}

• copy[color ff0000]

出力

hello
hel
llo

バージョン

言語

• C++17

処理系

• Clang: 4.0 [mark verified]
• GCC: 7.1 [mark verified]
• ICC: ??
• Visual C++: ??

参照

• P1032R1 Misc constexpr bits