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

部分文字列 [ pos , pos + count ) を dest が指す文字列にコピーします。要求された部分文字列が文字列の終端を超える場合、または count == npos の場合、コピーされる部分文字列は [ pos , size() ) となります。

結果の文字列はnull終端されていません。

パラメータ

戻り値

コピーされた文字数。

例外

std::out_of_range pos が pos > size ( ) の場合。

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

計算量

count に対して線形。

例

#include <iostream>
#include <string>
int main()
{
    std::string foo("WINE");
    // 波括弧初期化は全ての文字を0で初期化し、
    // ナルターミネータを提供する
    char bar[4]{};
    // ナルターミネーションを保証するため、最後の文字はコピーしない
    foo.copy(bar, sizeof bar - 1);
    std::cout << bar << '\n'; // barがナルターミネートされている必要がある
}

WIN

不具合報告

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

関連項目