ref と out を使用した配列の引き渡し (C# プログラミング ガイド)
すべての out パラメーターと同じように、配列型の out パラメーターも使用する前に代入される必要があります。つまり、呼び出される側で代入する必要があります。 次に例を示します。
static void TestMethod1(out int[] arr)
{
arr = new int[10]; // definite assignment of arr
}
すべての ref パラメーターと同じように、配列型の ref パラメーターも、呼び出し側で明示的に代入する必要があります。 したがって、呼び出される側で明示的に代入する必要はありません。 配列型の ref パラメーターは、呼び出しの結果として変更される場合があります。 たとえば、配列に null 値が代入されたり、別の配列で初期化されたりする場合があります。 次に例を示します。
static void TestMethod2(ref int[] arr)
{
arr = new int[10]; // arr initialized to a different array
}
次の 2 つの例は、メソッドに配列を渡すときに使われる out と ref の違いを示しています。
使用例
この例では、配列 theArray は呼び出し元 (Main メソッド) で宣言されて、FillArray メソッドで初期化されます。 その後、配列要素は呼び出し元に返されて表示されます。
class TestOut
{
static void FillArray(out int[] arr)
{
// Initialize the array:
arr = new int[5] { 1, 2, 3, 4, 5 };
}
static void Main()
{
int[] theArray; // Initialization is not required
// Pass the array to the callee using out:
FillArray(out theArray);
// Display the array elements:
System.Console.WriteLine("Array elements are:");
for (int i = 0; i < theArray.Length; i++)
{
System.Console.Write(theArray[i] + " ");
}
// Keep the console window open in debug mode.
System.Console.WriteLine("Press any key to exit.");
System.Console.ReadKey();
}
}
/* Output:
Array elements are:
1 2 3 4 5
*/
この例では、配列 theArray は呼び出し元 (Main メソッド) で初期化された後、ref パラメーターを使って FillArray メソッドに渡されます。 一部の配列要素は、FillArray メソッドの中で変更されます。 その後、配列要素は呼び出し元に返されて表示されます。
class TestRef
{
static void FillArray(ref int[] arr)
{
// Create the array on demand:
if (arr == null)
{
arr = new int[10];
}
// Fill the array:
arr[0] = 1111;
arr[4] = 5555;
}
static void Main()
{
// Initialize the array:
int[] theArray = { 1, 2, 3, 4, 5 };
// Pass the array using ref:
FillArray(ref theArray);
// Display the updated array:
System.Console.WriteLine("Array elements are:");
for (int i = 0; i < theArray.Length; i++)
{
System.Console.Write(theArray[i] + " ");
}
// Keep the console window open in debug mode.
System.Console.WriteLine("Press any key to exit.");
System.Console.ReadKey();
}
}
/* Output:
Array elements are:
1111 2 3 4 5555
*/