Array.Reverse Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Inverse l’ordre des éléments dans un Array unidimensionnel ou dans une partie du Array.

Surcharges

Reverse(Array)	Inverse la séquence des éléments dans l’ensemble de l'Arrayunidimensionnel .
Reverse(Array, Int32, Int32)	Inverse la séquence d’un sous-ensemble des éléments de l'Arrayunidimensionnel .
Reverse<T>(T[])	Inverse la séquence des éléments dans le tableau générique unidimensionnel.
Reverse<T>(T[], Int32, Int32)	Inverse la séquence d’un sous-ensemble des éléments dans le tableau générique unidimensionnel.

Reverse(Array)

Source:

Array.cs

Inverse la séquence des éléments dans l’ensemble de l'Arrayunidimensionnel .

C#

public static void Reverse (Array array);

Paramètres

array

Array

L'Array unidimensionnel à inverser.

Exceptions

ArgumentNullException

array est null.

RankException

array est multidimensionnel.

Exemples

L’exemple de code suivant montre comment inverser le tri des valeurs dans un Array.

C#

using System;
public class SamplesArray  {

   public static void Main()  {

      // Creates and initializes a new Array.
      Array myArray=Array.CreateInstance( typeof(string), 9 );
      myArray.SetValue( "The", 0 );
      myArray.SetValue( "quick", 1 );
      myArray.SetValue( "brown", 2 );
      myArray.SetValue( "fox", 3 );
      myArray.SetValue( "jumps", 4 );
      myArray.SetValue( "over", 5 );
      myArray.SetValue( "the", 6 );
      myArray.SetValue( "lazy", 7 );
      myArray.SetValue( "dog", 8 );

      // Displays the values of the Array.
      Console.WriteLine( "The Array initially contains the following values:" );
      PrintIndexAndValues( myArray );

      // Reverses the sort of the values of the Array.
      Array.Reverse( myArray );

      // Displays the values of the Array.
      Console.WriteLine( "After reversing:" );
      PrintIndexAndValues( myArray );
   }

   public static void PrintIndexAndValues( Array myArray )  {
      for ( int i = myArray.GetLowerBound(0); i <= myArray.GetUpperBound(0); i++ )
         Console.WriteLine( "\t[{0}]:\t{1}", i, myArray.GetValue( i ) );
   }
}
/*
This code produces the following output.

The Array initially contains the following values:
    [0]:    The
    [1]:    quick
    [2]:    brown
    [3]:    fox
    [4]:    jumps
    [5]:    over
    [6]:    the
    [7]:    lazy
    [8]:    dog
After reversing:
    [0]:    dog
    [1]:    lazy
    [2]:    the
    [3]:    over
    [4]:    jumps
    [5]:    fox
    [6]:    brown
    [7]:    quick
    [8]:    The
*/

Remarques

Après un appel à cette méthode, l’élément à myArray[i], où i est n’importe quel index dans le tableau, passe à myArray[j], où j est égal à (myArray.Length + myArray.GetLowerBound(0)) - (i - myArray.GetLowerBound(0)) - 1.

Cette méthode est une opération O(n), où n est la Length de array.

Dans F#, la fonction Array.rev peut être utilisée à la place.

Comme l’illustre l’exemple suivant, la méthode Reverse peut être utilisée pour inverser un tableau en jaquet. Il initialise un tableau en jaquet avec un élément pour chaque mois de l’année en cours dans le calendrier de la culture actuelle. Chaque élément contient un tableau avec autant d’éléments que ce mois-ci a des jours. L’exemple affiche le contenu du tableau, appelle la méthode Reverse, puis affiche le contenu du tableau inversé.

C#

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      int nMonths = DateTimeFormatInfo.CurrentInfo.Calendar.GetMonthsInYear(DateTime.Now.Year);
      int[][] months = new int[nMonths][];

      // Populate elements with number of days in month.
      for (int ctr = 0; ctr <= months.GetUpperBound(0); ctr++) {
         int daysInMonth = DateTime.DaysInMonth(DateTime.Now.Year, ctr + 1);
         months[ctr] = new int[daysInMonth] ;
         for (int ctr2 = 1; ctr2 <= daysInMonth; ctr2++)
            months[ctr][ctr2 - 1] = ctr2;
      }

      foreach (var month in months) {
         foreach (var day in month)
            Console.Write("{0} ", day);

         Console.WriteLine();
      }
      Console.WriteLine();

      Console.WriteLine("About to reverse array.\n");
      Array.Reverse(months);

      foreach (var month in months) {
         foreach (var day in month)
            Console.Write("{0} ", day);

         Console.WriteLine();
      }
   }
}
// The example displays output similar to the following:
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//
//    About to reverse array.
//
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29
//    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

Reverse(Array, Int32, Int32)

Source:

Array.cs

Inverse la séquence d’un sous-ensemble des éléments de l'Arrayunidimensionnel .

C#

public static void Reverse (Array array, int index, int length);

Paramètres

array

Array

L'Array unidimensionnel à inverser.

index

Int32

Index de départ de la section à inverser.

length

Int32

Nombre d’éléments de la section à inverser.

Exceptions

ArgumentNullException

array est null.

RankException

array est multidimensionnel.

ArgumentOutOfRangeException

index est inférieur à la limite inférieure de array.

-ou-

length est inférieur à zéro.

ArgumentException

index et length ne spécifient pas de plage valide dans array.

Exemples

L’exemple de code suivant montre comment inverser le tri des valeurs dans une plage d’éléments d’un Array.

C#

using System;
public class SamplesArray1  {

   public static void Main()  {

      // Creates and initializes a new Array.
      Array myArray=Array.CreateInstance( typeof(string), 9 );
      myArray.SetValue( "The", 0 );
      myArray.SetValue( "QUICK", 1 );
      myArray.SetValue( "BROWN", 2 );
      myArray.SetValue( "FOX", 3 );
      myArray.SetValue( "jumps", 4 );
      myArray.SetValue( "over", 5 );
      myArray.SetValue( "the", 6 );
      myArray.SetValue( "lazy", 7 );
      myArray.SetValue( "dog", 8 );

      // Displays the values of the Array.
      Console.WriteLine( "The Array initially contains the following values:" );
      PrintIndexAndValues( myArray );

      // Reverses the sort of the values of the Array.
      Array.Reverse( myArray, 1, 3 );

      // Displays the values of the Array.
      Console.WriteLine( "After reversing:" );
      PrintIndexAndValues( myArray );
   }

   public static void PrintIndexAndValues( Array myArray )  {
      for ( int i = myArray.GetLowerBound(0); i <= myArray.GetUpperBound(0); i++ )
         Console.WriteLine( "\t[{0}]:\t{1}", i, myArray.GetValue( i ) );
   }
}
/*
This code produces the following output.

The Array initially contains the following values:
    [0]:    The
    [1]:    QUICK
    [2]:    BROWN
    [3]:    FOX
    [4]:    jumps
    [5]:    over
    [6]:    the
    [7]:    lazy
    [8]:    dog
After reversing:
    [0]:    The
    [1]:    FOX
    [2]:    BROWN
    [3]:    QUICK
    [4]:    jumps
    [5]:    over
    [6]:    the
    [7]:    lazy
    [8]:    dog
*/

Remarques

Après un appel à cette méthode, l’élément à myArray[i], où i est n’importe quel index dans le tableau, passe à myArray[j], où j est égal à (myArray.Length + myArray.GetLowerBound(0)) - (i - myArray.GetLowerBound(0)) - 1.

La méthode Reverse peut être utilisée pour inverser un tableau en jaquet.

Cette méthode est une opération O(n), où n est length.

Reverse<T>(T[])

Source:

Array.cs

Inverse la séquence des éléments dans le tableau générique unidimensionnel.

C#

public static void Reverse<T> (T[] array);

Paramètres de type

T

Type des éléments dans array.

Paramètres

array

T[]

Tableau unidimensionnel d’éléments à inverser.

Exceptions

ArgumentNullException

array est null.

RankException

array est multidimensionnel.

Reverse<T>(T[], Int32, Int32)

Source:

Array.cs

Inverse la séquence d’un sous-ensemble des éléments dans le tableau générique unidimensionnel.

C#

public static void Reverse<T> (T[] array, int index, int length);

Paramètres de type

T

Type des éléments dans array.

Paramètres

array

T[]

Tableau unidimensionnel d’éléments à inverser.

index

Int32

Index de départ de la section à inverser.

length

Int32

Nombre d’éléments de la section à inverser.

Exceptions

ArgumentNullException

array est null.

RankException

array est multidimensionnel.

ArgumentOutOfRangeException

index est inférieur à la limite inférieure de array.

-ou-

length est inférieur à zéro.

ArgumentException

index et length ne spécifient pas de plage valide dans array.