Passaggio di matrici mediante ref e out (Guida per programmatori C#)

Aggiornamento: novembre 2007

Analogamente a tutti i parametri out, anche il parametro out di un tipo matrice deve essere assegnato prima dell'uso, ovvero assegnato dal chiamato. Esempio:

static void TestMethod1(out int[] arr)
{
    arr = new int[10];   // definite assignment of arr
}

Come tutti i parametri ref, anche il parametro ref di un tipo matrice deve essere assolutamente assegnato dal chiamante. Non è pertanto necessario che venga assegnato dalla procedura che viene chiamata. Il parametro ref di un tipo matrice può risultare modificato in conseguenza della chiamata. È ad esempio possibile che alla matrice venga assegnato il valore null o che essa venga inizializzata con una matrice diversa. Esempio:

static void TestMethod2(ref int[] arr)
{
    arr = new int[10];   // arr initialized to a different array
}

Nei due esempi che seguono viene illustrata la differenza tra out e ref quando vengono utilizzati per passare matrici a metodi.

Esempio

In questo esempio la matrice theArray viene dichiarata nel chiamante (il metodo Main) e inizializzata nel metodo FillArray. Gli elementi vengono quindi restituiti al chiamante e visualizzati.

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        
    */

In questo esempio la matrice theArray viene inizializzata nel chiamante (il metodo Main) e passata al metodo FillArray utilizzando il parametro ref. Alcuni degli elementi della matrice vengono aggiornati nel metodo FillArray. Gli elementi vengono quindi restituiti al chiamante e visualizzati.

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
    */

Vedere anche

Concetti

Guida per programmatori C#

Riferimenti

Matrici (Guida per programmatori C#)

Matrici unidimensionali (Guida per programmatori C#)

Matrici multidimensionali (Guida per programmatori C#)

Matrici irregolari (Guida per programmatori C#)