【C#】Queueの要素を1次元配列にコピーする方法（CopyToメソッドの使い方）

C#の Queue<T>.CopyTo(T[], Int32) メソッドを使うと、キュー（Queue）内の要素を指定した位置から1次元配列へコピーできます。既存の配列にキューの内容を統合したい場合などに便利なメソッドです。

基本構文

queue.CopyTo(array, arrayIndex);

• array：コピー先となる1次元配列
• arrayIndex：コピーを開始する配列のインデックス（0から始まる）

サンプルコード

実際に CopyTo メソッドを使用した例を見てみましょう。

using System;
using System.Collections.Generic;

public class Demo {
    public static void Main() {
        Queue<string> queue = new Queue<string>();
        queue.Enqueue("K");
        queue.Enqueue("T");

        String[] strArr = new String[4];
        strArr[0] = "One";
        strArr[1] = "Two";
        strArr[2] = "Three";
        strArr[3] = "Four";

        Console.WriteLine("\nArray elements: ");
        for (int i = 0; i < strArr.Length; i++) {
            Console.WriteLine(strArr[i]);
        }

        // 配列のインデックス2以降にキューの要素をコピー
        queue.CopyTo(strArr, 2);

        Console.WriteLine("\nAfter copying array contains: ");
        for (int i = 0; i < strArr.Length; i++) {
            Console.WriteLine("arr[{0}] : {1}", i, strArr[i]);
        }
    }
}

実行結果

上記のコードを実行すると、以下のような出力が得られます。

One
Two
Three
Four
After copying array contains:
arr[0] : One
arr[1] : Two
arr[2] : K
arr[3] : T

解説

この例では、まず「K」「T」の2つの要素をキューに追加しています。初期状態の配列には「One」「Two」「Three」「Four」が格納されています。

queue.CopyTo(strArr, 2) を呼び出すと、キューの要素が配列のインデックス2以降に順番に上書きされます。そのため、「Three」と「Four」がキューの要素「K」と「T」で置き換えられ、先頭の2つの要素はそのまま残ります。

注意点

• コピー先の配列は、開始インデックスからキューの要素数分の空きが必要です。容量が不足している場合は ArgumentException がスローされます。
• 配列やインデックスが null の場合も例外が発生するため、事前のチェックを推奨します。