C#のString.Copy()とString.CopyTo()メソッドの違いとは？

C#のString.Copy()とString.CopyTo()の違いとは？

C#には文字列をコピーするためのメソッドとして、名前がよく似たString.Copy()とString.CopyTo()の2つが用意されています。しかし、この2つは目的も動作もまったく異なります。

• String.Copy() … 文字列全体を複製し、同じ内容を持つ新しい文字列オブジェクトを作成する
• String.CopyTo() … 文字列の一部（指定範囲の文字）を、既存のchar型配列にコピーする

以下、それぞれのメソッドについて詳しく見ていきましょう。

String.CopyTo()メソッド：文字列の一部をchar型配列へコピー

String.CopyTo()は、ソース文字列から指定した位置以降の文字群を取り出し、char型配列の指定した位置へコピーします。引数は次の4つです。

• コピー元の開始インデックス
• コピー先のchar型配列
• 配列への書き込み開始インデックス
• コピーする文字数

サンプルコード

using System;
class Demo {

    static void Main(String[] args) {
        string str = "This is it!";
        char[] ch = new char[5];

        str.CopyTo(2, ch, 0, 2);

        Console.WriteLine("Output...");
        Console.WriteLine(ch);
    }
}

実行結果

Output...
is

この例では、文字列「This is it!」のインデックス2以降から2文字分（「is」）を、配列chの先頭にコピーしています。

String.Copy()メソッド：同じ内容の新しい文字列を作成

String.Copy()は、指定した文字列と同じ内容を持つ新しいstringオブジェクトを生成します。元の文字列とは独立した別インスタンスが作られる点がポイントです。

サンプルコード

using System;
class Demo {
    static void Main(String[] args) {

        string str1 = "Welcome!";
        string str2 = "user";
        str2 = String.Copy(str1);

        Console.WriteLine("Output...");
        Console.WriteLine(str2);
    }
}

実行結果

Output...
Welcome!

この例では、str1の内容「Welcome!」がstr2にコピーされ、str2を出力すると「Welcome!」と表示されます。

2つのメソッドの違いまとめ

補足：String.Copy()は非推奨

.NET Core 3.0以降では、String.Copy()は非推奨（Obsolete）とされています。C#の文字列は不変（イミュータブル）であるため、単純に代入演算子（=）で参照を渡すだけで十分安全だからです。新規のコードでは、string str2 = str1;のように代入を使用することが推奨されています。