引数としての配列の受け渡し (C# プログラミング ガイド)
配列は引数としてメソッド パラメーターに渡すことができます。配列は参照型であるため、メソッドで要素の値を変更できます。
引数としての 1 次元配列の受け渡し
初期化された 1 次元配列をメソッドに渡すことができます。たとえば、次のステートメントは配列を印刷メソッドに渡します。
int[] theArray = { 1, 3, 5, 7, 9 };
PrintArray(theArray);
印刷メソッドの部分的な実装を次のコードに示します。
void PrintArray(int[] arr)
{
// Method code.
}
次の例に示すように、新しい配列の初期化と受け渡しを 1 ステップで行うことができます。
PrintArray(new int[] { 1, 3, 5, 7, 9 });
例
Description
次の例では、文字列の配列は初期化され、文字列の PrintArray メソッドに引数として渡されます。メソッドは配列の要素を表示します。次に、配列引数を値渡しで送信しても、配列要素の変更の妨げにはならないことを示すために、ChangeArray メソッドと ChangeArrayElement メソッドが呼び出されています。
コード
class ArrayClass
{
static void PrintArray(string[] arr)
{
for (int i = 0; i < arr.Length; i++)
{
System.Console.Write(arr[i] + "{0}", i < arr.Length - 1 ? " " : "");
}
System.Console.WriteLine();
}
static void ChangeArray(string[] arr)
{
// The following attempt to reverse the array does not persist when
// the method returns, because arr is a value parameter.
arr = (arr.Reverse()).ToArray();
// The following statement displays Sat as the first element in the array.
System.Console.WriteLine("arr[0] is {0} in ChangeArray.", arr[0]);
}
static void ChangeArrayElements(string[] arr)
{
// The following assignments change the value of individual array
// elements.
arr[0] = "Sat";
arr[1] = "Fri";
arr[2] = "Thu";
// The following statement again displays Sat as the first element
// in the array arr, inside the called method.
System.Console.WriteLine("arr[0] is {0} in ChangeArrayElements.", arr[0]);
}
static void Main()
{
// Declare and initialize an array.
string[] weekDays = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" };
// Pass the array as an argument to PrintArray.
PrintArray(weekDays);
// ChangeArray tries to change the array by assigning something new
// to the array in the method.
ChangeArray(weekDays);
// Print the array again, to verify that it has not been changed.
System.Console.WriteLine("Array weekDays after the call to ChangeArray:");
PrintArray(weekDays);
System.Console.WriteLine();
// ChangeArrayElements assigns new values to individual array
// elements.
ChangeArrayElements(weekDays);
// The changes to individual elements persist after the method returns.
// Print the array, to verify that it has been changed.
System.Console.WriteLine("Array weekDays after the call to ChangeArrayElements:");
PrintArray(weekDays);
}
}
// Output:
// Sun Mon Tue Wed Thu Fri Sat
// arr[0] is Sat in ChangeArray.
// Array weekDays after the call to ChangeArray:
// Sun Mon Tue Wed Thu Fri Sat
//
// arr[0] is Sat in ChangeArrayElements.
// Array weekDays after the call to ChangeArrayElements:
// Sat Fri Thu Wed Thu Fri Sat
引数としての多次元配列の受け渡し
初期化された多次元配列は、1 次元配列を渡す場合と同じ方法でメソッドに渡します。
int[,] theArray = { { 1, 2 }, { 2, 3 }, { 3, 4 } };
Print2DArray(theArray);
2 次元配列を引数として受け入れる印刷メソッドの部分宣言を次のコードに示します。
void Print2DArray(int[,] arr)
{
// Method code.
}
次の例に示すように、新しい配列の初期化と受け渡しを 1 ステップで行うことができます。
Print2DArray(new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } });
例
Description
次の例では、整数の 2 次元配列を初期化し、Print2DArray メソッドに渡します。メソッドは配列の要素を表示します。
コード
class ArrayClass2D
{
static void Print2DArray(int[,] arr)
{
// Display the array elements.
for (int i = 0; i < arr.GetLength(0); i++)
{
for (int j = 0; j < arr.GetLength(1); j++)
{
System.Console.WriteLine("Element({0},{1})={2}", i, j, arr[i, j]);
}
}
}
static void Main()
{
// Pass the array as an argument.
Print2DArray(new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } });
// Keep the console window open in debug mode.
System.Console.WriteLine("Press any key to exit.");
System.Console.ReadKey();
}
}
/* Output:
Element(0,0)=1
Element(0,1)=2
Element(1,0)=3
Element(1,1)=4
Element(2,0)=5
Element(2,1)=6
Element(3,0)=7
Element(3,1)=8
*/