List<T>.BinarySearch Méthode

Définition

Utilise un algorithme de recherche binaire pour trouver un élément spécifique dans le List<T> trié ou une partie de celui-ci.Uses a binary search algorithm to locate a specific element in the sorted List<T> or a portion of it.

Surcharges

BinarySearch(T)

Recherche un élément utilisant le comparateur par défaut dans le List<T> entièrement trié et retourne l'index de base zéro de l'élément.Searches the entire sorted List<T> for an element using the default comparer and returns the zero-based index of the element.

BinarySearch(T, IComparer<T>)

Recherche un élément utilisant le comparateur spécifié dans le List<T> entièrement trié et retourne l'index de base zéro de l'élément.Searches the entire sorted List<T> for an element using the specified comparer and returns the zero-based index of the element.

BinarySearch(Int32, Int32, T, IComparer<T>)

Recherche un élément utilisant le comparateur spécifié dans une plage d'éléments du List<T> trié et retourne l'index de base zéro de l'élément.Searches a range of elements in the sorted List<T> for an element using the specified comparer and returns the zero-based index of the element.

BinarySearch(T)

Recherche un élément utilisant le comparateur par défaut dans le List<T> entièrement trié et retourne l'index de base zéro de l'élément.Searches the entire sorted List<T> for an element using the default comparer and returns the zero-based index of the element.

public:
 int BinarySearch(T item);
public int BinarySearch (T item);
member this.BinarySearch : 'T -> int
Public Function BinarySearch (item As T) As Integer

Paramètres

item
T

Objet à trouver.The object to locate. La valeur peut être null pour les types référence.The value can be null for reference types.

Retours

Index de base zéro de item dans le List<T> trié, si item existe ; sinon, un nombre négatif qui est le complément de bits de l'index de l'élément suivant supérieur à item ou, s'il n'existe aucun élément supérieur, le complément de bits de Count.The zero-based index of item in the sorted List<T>, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than item or, if there is no larger element, the bitwise complement of Count.

Exceptions

Le comparateur par défaut Default ne peut pas trouver une implémentation de l’interface générique IComparable<T> ou de l’interface IComparable pour le type T.The default comparer Default cannot find an implementation of the IComparable<T> generic interface or the IComparable interface for type T.

Exemples

L’exemple suivant illustre la surcharge de méthode Sort() et la surcharge de méthode BinarySearch(T).The following example demonstrates the Sort() method overload and the BinarySearch(T) method overload. Une List<T> de chaînes est créée et remplie avec quatre chaînes, dans aucun ordre particulier.A List<T> of strings is created and populated with four strings, in no particular order. La liste s’affiche, est triée et s’affiche à nouveau.The list is displayed, sorted, and displayed again.

La surcharge de méthode BinarySearch(T) est ensuite utilisée pour rechercher deux chaînes qui ne sont pas dans la liste, et la méthode Insert est utilisée pour les insérer.The BinarySearch(T) method overload is then used to search for two strings that are not in the list, and the Insert method is used to insert them. La valeur de retour de la méthode BinarySearch(T) est négative dans chaque cas, car les chaînes ne sont pas dans la liste.The return value of the BinarySearch(T) method is negative in each case, because the strings are not in the list. En prenant le complément de bits (l’opérateur C# ~ dans C++et Visual, Xor-1 en Visual Basic) de ce nombre négatif produit l’index du premier élément de la liste qui est plus grand que la chaîne de recherche, et l’insertion à cet emplacement conserve l’ordre de tri.Taking the bitwise complement (the ~ operator in C# and Visual C++, Xor -1 in Visual Basic) of this negative number produces the index of the first element in the list that is larger than the search string, and inserting at this location preserves the sort order. La deuxième chaîne de recherche est plus grande que n’importe quel élément de la liste, donc la position d’insertion se trouve à la fin de la liste.The second search string is larger than any element in the list, so the insertion position is at the end of the list.

using namespace System;
using namespace System::Collections::Generic;

void main()
{
    List<String^>^ dinosaurs = gcnew List<String^>();

    dinosaurs->Add("Pachycephalosaurus");
    dinosaurs->Add("Amargasaurus");
    dinosaurs->Add("Mamenchisaurus");
    dinosaurs->Add("Deinonychus");

    Console::WriteLine();
    for each(String^ dinosaur in dinosaurs)
    {
        Console::WriteLine(dinosaur);
    }

    Console::WriteLine("\nSort");
    dinosaurs->Sort();

    Console::WriteLine();
    for each(String^ dinosaur in dinosaurs)
    {
        Console::WriteLine(dinosaur);
    }

    Console::WriteLine("\nBinarySearch and Insert \"Coelophysis\":");
    int index = dinosaurs->BinarySearch("Coelophysis");
    if (index < 0)
    {
        dinosaurs->Insert(~index, "Coelophysis");
    }

    Console::WriteLine();
    for each(String^ dinosaur in dinosaurs)
    {
        Console::WriteLine(dinosaur);
    }

    Console::WriteLine("\nBinarySearch and Insert \"Tyrannosaurus\":");
    index = dinosaurs->BinarySearch("Tyrannosaurus");
    if (index < 0)
    {
        dinosaurs->Insert(~index, "Tyrannosaurus");
    }

    Console::WriteLine();
    for each(String^ dinosaur in dinosaurs)
    {
        Console::WriteLine(dinosaur);
    }
}

/* This code example produces the following output:

Pachycephalosaurus
Amargasaurus
Mamenchisaurus
Deinonychus

Sort

Amargasaurus
Deinonychus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Coelophysis":

Amargasaurus
Coelophysis
Deinonychus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Tyrannosaurus":

Amargasaurus
Coelophysis
Deinonychus
Mamenchisaurus
Pachycephalosaurus
Tyrannosaurus
 */
List<string> dinosaurs = new List<string>();

dinosaurs.Add("Pachycephalosaurus");
dinosaurs.Add("Amargasaurus");
dinosaurs.Add("Mamenchisaurus");
dinosaurs.Add("Deinonychus");

Console.WriteLine("Initial list:");
Console.WriteLine();
foreach(string dinosaur in dinosaurs)
{
    Console.WriteLine(dinosaur);
}

Console.WriteLine("\nSort:");
dinosaurs.Sort();

Console.WriteLine();
foreach(string dinosaur in dinosaurs)
{
    Console.WriteLine(dinosaur);
}

Console.WriteLine("\nBinarySearch and Insert \"Coelophysis\":");
int index = dinosaurs.BinarySearch("Coelophysis");
if (index < 0)
{
    dinosaurs.Insert(~index, "Coelophysis");
}

Console.WriteLine();
foreach(string dinosaur in dinosaurs)
{
    Console.WriteLine(dinosaur);
}

Console.WriteLine("\nBinarySearch and Insert \"Tyrannosaurus\":");
index = dinosaurs.BinarySearch("Tyrannosaurus");
if (index < 0)
{
    dinosaurs.Insert(~index, "Tyrannosaurus");
}

Console.WriteLine();
foreach(string dinosaur in dinosaurs)
{
    Console.WriteLine(dinosaur);
}
/* This code example produces the following output:

Initial list:

Pachycephalosaurus
Amargasaurus
Mamenchisaurus
Deinonychus

Sort:

Amargasaurus
Deinonychus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Coelophysis":

Amargasaurus
Coelophysis
Deinonychus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Tyrannosaurus":

Amargasaurus
Coelophysis
Deinonychus
Mamenchisaurus
Pachycephalosaurus
Tyrannosaurus
*/
Imports System.Collections.Generic

Public Class Example

    Public Shared Sub Main()

        Dim dinosaurs As New List(Of String)

        dinosaurs.Add("Pachycephalosaurus")
        dinosaurs.Add("Amargasaurus")
        dinosaurs.Add("Mamenchisaurus")
        dinosaurs.Add("Deinonychus")

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        Console.WriteLine(vbLf & "Sort")
        dinosaurs.Sort

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        Console.WriteLine(vbLf & _
            "BinarySearch and Insert ""Coelophysis"":")
        Dim index As Integer = dinosaurs.BinarySearch("Coelophysis")
        If index < 0 Then
            index = index Xor -1
            dinosaurs.Insert(index, "Coelophysis")
        End If

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        Console.WriteLine(vbLf & _
            "BinarySearch and Insert ""Tyrannosaurus"":")
        index = dinosaurs.BinarySearch("Tyrannosaurus")
        If index < 0 Then
            index = index Xor -1
            dinosaurs.Insert(index, "Tyrannosaurus")
        End If

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

    End Sub
End Class

' This code example produces the following output:
'
'Pachycephalosaurus
'Amargasaurus
'Mamenchisaurus
'Deinonychus
'
'Sort
'
'Amargasaurus
'Deinonychus
'Mamenchisaurus
'Pachycephalosaurus
'
'BinarySearch and Insert "Coelophysis":
'
'Amargasaurus
'Coelophysis
'Deinonychus
'Mamenchisaurus
'Pachycephalosaurus
'
'BinarySearch and Insert "Tyrannosaurus":
'
'Amargasaurus
'Coelophysis
'Deinonychus
'Mamenchisaurus
'Pachycephalosaurus
'Tyrannosaurus

Remarques

Cette méthode utilise le comparateur par défaut Comparer<T>.Default pour le type T pour déterminer l’ordre des éléments de liste.This method uses the default comparer Comparer<T>.Default for type T to determine the order of list elements. La propriété Comparer<T>.Default vérifie si le type T implémente l’interface générique IComparable<T> et utilise cette implémentation, si elle est disponible.The Comparer<T>.Default property checks whether type T implements the IComparable<T> generic interface and uses that implementation, if available. Si ce n’est pas le cas, Comparer<T>.Default vérifie si le type T implémente l’interface IComparable.If not, Comparer<T>.Default checks whether type T implements the IComparable interface. Si le type T n’implémente aucune interface, Comparer<T>.Default lève une InvalidOperationException.If type T does not implement either interface, Comparer<T>.Default throws an InvalidOperationException.

Le List<T> doit déjà être trié en fonction de l’implémentation du comparateur ; dans le cas contraire, le résultat est incorrect.The List<T> must already be sorted according to the comparer implementation; otherwise, the result is incorrect.

La comparaison de null avec n’importe quel type référence est autorisée et ne génère pas d’exception lors de l’utilisation de l’interface générique IComparable<T>.Comparing null with any reference type is allowed and does not generate an exception when using the IComparable<T> generic interface. Lors du tri, null est considéré comme inférieur à tout autre objet.When sorting, null is considered to be less than any other object.

Si le List<T> contient plus d’un élément avec la même valeur, la méthode ne retourne qu’une seule occurrence, et peut retourner l’une des occurrences, pas nécessairement la première.If the List<T> contains more than one element with the same value, the method returns only one of the occurrences, and it might return any one of the occurrences, not necessarily the first one.

Si le List<T> ne contient pas la valeur spécifiée, la méthode retourne un entier négatif.If the List<T> does not contain the specified value, the method returns a negative integer. Vous pouvez appliquer l’opération de complément au niveau du bit (~) à cet entier négatif pour récupérer l’index du premier élément supérieur à la valeur de recherche.You can apply the bitwise complement operation (~) to this negative integer to get the index of the first element that is larger than the search value. Lors de l’insertion de la valeur dans le List<T>, cet index doit être utilisé comme point d’insertion pour conserver l’ordre de tri.When inserting the value into the List<T>, this index should be used as the insertion point to maintain the sort order.

Cette méthode est une opération O (log n), où n est le nombre d’éléments de la plage.This method is an O(log n) operation, where n is the number of elements in the range.

Voir aussi

BinarySearch(T, IComparer<T>)

Recherche un élément utilisant le comparateur spécifié dans le List<T> entièrement trié et retourne l'index de base zéro de l'élément.Searches the entire sorted List<T> for an element using the specified comparer and returns the zero-based index of the element.

public:
 int BinarySearch(T item, System::Collections::Generic::IComparer<T> ^ comparer);
public int BinarySearch (T item, System.Collections.Generic.IComparer<T> comparer);
member this.BinarySearch : 'T * System.Collections.Generic.IComparer<'T> -> int
Public Function BinarySearch (item As T, comparer As IComparer(Of T)) As Integer

Paramètres

item
T

Objet à trouver.The object to locate. La valeur peut être null pour les types référence.The value can be null for reference types.

comparer
IComparer<T>

Implémentation de IComparer<T> à utiliser pendant la comparaison d'éléments.The IComparer<T> implementation to use when comparing elements.

-ou--or- null pour utiliser le comparateur par défaut Default.null to use the default comparer Default.

Retours

Index de base zéro de item dans le List<T> trié, si item existe ; sinon, un nombre négatif qui est le complément de bits de l'index de l'élément suivant supérieur à item ou, s'il n'existe aucun élément supérieur, le complément de bits de Count.The zero-based index of item in the sorted List<T>, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than item or, if there is no larger element, the bitwise complement of Count.

Exceptions

comparer est null, et le comparateur par défaut Default ne peut pas trouver une implémentation de l’interface générique IComparable<T> ou de l’interface IComparable pour le type T.comparer is null, and the default comparer Default cannot find an implementation of the IComparable<T> generic interface or the IComparable interface for type T.

Exemples

L’exemple suivant illustre la surcharge de méthode Sort(IComparer<T>) et la surcharge de méthode BinarySearch(T, IComparer<T>).The following example demonstrates the Sort(IComparer<T>) method overload and the BinarySearch(T, IComparer<T>) method overload.

L’exemple définit un autre comparateur pour les chaînes nommées DinoCompare, qui implémente le IComparer<string> (IComparer(Of String) dans Visual Basic, C++IComparer<String^> en visuel) interface générique.The example defines an alternative comparer for strings named DinoCompare, which implements the IComparer<string> (IComparer(Of String) in Visual Basic, IComparer<String^> in Visual C++) generic interface. Le comparateur fonctionne comme suit : tout d’abord, les comparateurs sont testés pour null, et une référence null est traitée comme inférieure à une valeur non null.The comparer works as follows: First, the comparands are tested for null, and a null reference is treated as less than a non-null. Deuxièmement, les longueurs de chaîne sont comparées et la chaîne la plus longue est considérée comme supérieure.Second, the string lengths are compared, and the longer string is deemed to be greater. Troisièmement, si les longueurs sont égales, la comparaison de chaînes ordinaire est utilisée.Third, if the lengths are equal, ordinary string comparison is used.

Une List<T> de chaînes est créée et remplie avec quatre chaînes, dans aucun ordre particulier.A List<T> of strings is created and populated with four strings, in no particular order. La liste est affichée, triée à l’aide de l’autre comparateur et affichée à nouveau.The list is displayed, sorted using the alternate comparer, and displayed again.

La surcharge de méthode BinarySearch(T, IComparer<T>) est ensuite utilisée pour rechercher plusieurs chaînes qui ne sont pas dans la liste, en utilisant le comparateur de remplacement.The BinarySearch(T, IComparer<T>) method overload is then used to search for several strings that are not in the list, employing the alternate comparer. La méthode Insert est utilisée pour insérer les chaînes.The Insert method is used to insert the strings. Ces deux méthodes se trouvent dans la fonction nommée SearchAndInsert, ainsi que le code pour prendre le complément de bits (l’opérateur C# ~ dans C++et Visual, Xor-1 dans Visual Basic) du nombre négatif retourné par BinarySearch(T, IComparer<T>) et l’utiliser comme index pour insérer la nouvelle chaîne.These two methods are located in the function named SearchAndInsert, along with code to take the bitwise complement (the ~ operator in C# and Visual C++, Xor -1 in Visual Basic) of the negative number returned by BinarySearch(T, IComparer<T>) and use it as an index for inserting the new string.

using namespace System;
using namespace System::Collections::Generic;

public ref class DinoComparer: IComparer<String^>
{
public:
    virtual int Compare(String^ x, String^ y)
    {
        if (x == nullptr)
        {
            if (y == nullptr)
            {
                // If x is null and y is null, they're
                // equal. 
                return 0;
            }
            else
            {
                // If x is null and y is not null, y
                // is greater. 
                return -1;
            }
        }
        else
        {
            // If x is not null...
            //
            if (y == nullptr)
                // ...and y is null, x is greater.
            {
                return 1;
            }
            else
            {
                // ...and y is not null, compare the 
                // lengths of the two strings.
                //
                int retval = x->Length.CompareTo(y->Length);

                if (retval != 0)
                {
                    // If the strings are not of equal length,
                    // the longer string is greater.
                    //
                    return retval;
                }
                else
                {
                    // If the strings are of equal length,
                    // sort them with ordinary string comparison.
                    //
                    return x->CompareTo(y);
                }
            }
        }
    }
};

void SearchAndInsert(List<String^>^ list, String^ insert, 
    DinoComparer^ dc)
{
    Console::WriteLine("\nBinarySearch and Insert \"{0}\":", insert);

    int index = list->BinarySearch(insert, dc);

    if (index < 0)
    {
        list->Insert(~index, insert);
    }
};

void Display(List<String^>^ list)
{
    Console::WriteLine();
    for each(String^ s in list)
    {
        Console::WriteLine(s);
    }
};

void main()
{
    List<String^>^ dinosaurs = gcnew List<String^>();
    dinosaurs->Add("Pachycephalosaurus");
    dinosaurs->Add("Amargasaurus");
    dinosaurs->Add("Mamenchisaurus");
    dinosaurs->Add("Deinonychus");
    Display(dinosaurs);

    DinoComparer^ dc = gcnew DinoComparer();

    Console::WriteLine("\nSort with alternate comparer:");
    dinosaurs->Sort(dc);
    Display(dinosaurs);

    SearchAndInsert(dinosaurs, "Coelophysis", dc);
    Display(dinosaurs);

    SearchAndInsert(dinosaurs, "Oviraptor", dc);
    Display(dinosaurs);

    SearchAndInsert(dinosaurs, "Tyrannosaur", dc);
    Display(dinosaurs);

    SearchAndInsert(dinosaurs, nullptr, dc);
    Display(dinosaurs);
}

/* This code example produces the following output:

Pachycephalosaurus
Amargasaurus
Mamenchisaurus
Deinonychus

Sort with alternate comparer:

Deinonychus
Amargasaurus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Coelophysis":

Coelophysis
Deinonychus
Amargasaurus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Oviraptor":

Oviraptor
Coelophysis
Deinonychus
Amargasaurus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Tyrannosaur":

Oviraptor
Coelophysis
Deinonychus
Tyrannosaur
Amargasaurus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "":


Oviraptor
Coelophysis
Deinonychus
Tyrannosaur
Amargasaurus
Mamenchisaurus
Pachycephalosaurus
 */
using System;
using System.Collections.Generic;

public class DinoComparer: IComparer<string>
{
    public int Compare(string x, string y)
    {
        if (x == null)
        {
            if (y == null)
            {
                // If x is null and y is null, they're
                // equal. 
                return 0;
            }
            else
            {
                // If x is null and y is not null, y
                // is greater. 
                return -1;
            }
        }
        else
        {
            // If x is not null...
            //
            if (y == null)
                // ...and y is null, x is greater.
            {
                return 1;
            }
            else
            {
                // ...and y is not null, compare the 
                // lengths of the two strings.
                //
                int retval = x.Length.CompareTo(y.Length);

                if (retval != 0)
                {
                    // If the strings are not of equal length,
                    // the longer string is greater.
                    //
                    return retval;
                }
                else
                {
                    // If the strings are of equal length,
                    // sort them with ordinary string comparison.
                    //
                    return x.CompareTo(y);
                }
            }
        }
    }
}

public class Example
{
    public static void Main()
    {
        List<string> dinosaurs = new List<string>();
        dinosaurs.Add("Pachycephalosaurus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("Mamenchisaurus");
        dinosaurs.Add("Deinonychus");
        Display(dinosaurs);

        DinoComparer dc = new DinoComparer();

        Console.WriteLine("\nSort with alternate comparer:");
        dinosaurs.Sort(dc);
        Display(dinosaurs);

        SearchAndInsert(dinosaurs, "Coelophysis", dc);
        Display(dinosaurs);

        SearchAndInsert(dinosaurs, "Oviraptor", dc);
        Display(dinosaurs);

        SearchAndInsert(dinosaurs, "Tyrannosaur", dc);
        Display(dinosaurs);

        SearchAndInsert(dinosaurs, null, dc);
        Display(dinosaurs);
    }

    private static void SearchAndInsert(List<string> list, 
        string insert, DinoComparer dc)
    {
        Console.WriteLine("\nBinarySearch and Insert \"{0}\":", insert);

        int index = list.BinarySearch(insert, dc);

        if (index < 0)
        {
            list.Insert(~index, insert);
        }
    }

    private static void Display(List<string> list)
    {
        Console.WriteLine();
        foreach( string s in list )
        {
            Console.WriteLine(s);
        }
    }
}

/* This code example produces the following output:

Pachycephalosaurus
Amargasaurus
Mamenchisaurus
Deinonychus

Sort with alternate comparer:

Deinonychus
Amargasaurus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Coelophysis":

Coelophysis
Deinonychus
Amargasaurus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Oviraptor":

Oviraptor
Coelophysis
Deinonychus
Amargasaurus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "Tyrannosaur":

Oviraptor
Coelophysis
Deinonychus
Tyrannosaur
Amargasaurus
Mamenchisaurus
Pachycephalosaurus

BinarySearch and Insert "":


Oviraptor
Coelophysis
Deinonychus
Tyrannosaur
Amargasaurus
Mamenchisaurus
Pachycephalosaurus
 */
Imports System.Collections.Generic

Public Class DinoComparer
    Implements IComparer(Of String)

    Public Function Compare(ByVal x As String, _
        ByVal y As String) As Integer _
        Implements IComparer(Of String).Compare

        If x Is Nothing Then
            If y Is Nothing Then 
                ' If x is Nothing and y is Nothing, they're
                ' equal. 
                Return 0
            Else
                ' If x is Nothing and y is not Nothing, y
                ' is greater. 
                Return -1
            End If
        Else
            ' If x is not Nothing...
            '
            If y Is Nothing Then
                ' ...and y is Nothing, x is greater.
                Return 1
            Else
                ' ...and y is not Nothing, compare the 
                ' lengths of the two strings.
                '
                Dim retval As Integer = _
                    x.Length.CompareTo(y.Length)

                If retval <> 0 Then 
                    ' If the strings are not of equal length,
                    ' the longer string is greater.
                    '
                    Return retval
                Else
                    ' If the strings are of equal length,
                    ' sort them with ordinary string comparison.
                    '
                    Return x.CompareTo(y)
                End If
            End If
        End If
    End Function
End Class

Public Class Example

    Public Shared Sub Main()

        Dim dinosaurs As New List(Of String)
        dinosaurs.Add("Pachycephalosaurus")
        dinosaurs.Add("Amargasaurus")
        dinosaurs.Add("Mamenchisaurus")
        dinosaurs.Add("Deinonychus")
        Display(dinosaurs)

        Dim dc As New DinoComparer

        Console.WriteLine(vbLf & "Sort with alternate comparer:")
        dinosaurs.Sort(dc)
        Display(dinosaurs)

        SearchAndInsert(dinosaurs, "Coelophysis", dc)
        Display(dinosaurs)

        SearchAndInsert(dinosaurs, "Oviraptor", dc)
        Display(dinosaurs)

        SearchAndInsert(dinosaurs, "Tyrannosaur", dc)
        Display(dinosaurs)

        SearchAndInsert(dinosaurs, Nothing, dc)
        Display(dinosaurs)
    End Sub

    Private Shared Sub SearchAndInsert( _
        ByVal lis As List(Of String), _
        ByVal insert As String, ByVal dc As DinoComparer)

        Console.WriteLine(vbLf & _
            "BinarySearch and Insert ""{0}"":", insert)

        Dim index As Integer = lis.BinarySearch(insert, dc)

        If index < 0 Then
            index = index Xor -1
            lis.Insert(index, insert)
        End If
    End Sub

    Private Shared Sub Display(ByVal lis As List(Of String))
        Console.WriteLine()
        For Each s As String In lis
            Console.WriteLine(s)
        Next
    End Sub
End Class

' This code example produces the following output:
'
'Pachycephalosaurus
'Amargasaurus
'Mamenchisaurus
'Deinonychus
'
'Sort with alternate comparer:
'
'Deinonychus
'Amargasaurus
'Mamenchisaurus
'Pachycephalosaurus
'
'BinarySearch and Insert "Coelophysis":
'
'Coelophysis
'Deinonychus
'Amargasaurus
'Mamenchisaurus
'Pachycephalosaurus
'
'BinarySearch and Insert "Oviraptor":
'
'Oviraptor
'Coelophysis
'Deinonychus
'Amargasaurus
'Mamenchisaurus
'Pachycephalosaurus
'
'BinarySearch and Insert "Tyrannosaur":
'
'Oviraptor
'Coelophysis
'Deinonychus
'Tyrannosaur
'Amargasaurus
'Mamenchisaurus
'Pachycephalosaurus
'
'BinarySearch and Insert "":
'
'
'Oviraptor
'Coelophysis
'Deinonychus
'Tyrannosaur
'Amargasaurus
'Mamenchisaurus
'Pachycephalosaurus

Remarques

Le comparateur personnalise la manière dont les éléments sont comparés.The comparer customizes how the elements are compared. Par exemple, vous pouvez utiliser une instance de CaseInsensitiveComparer comme comparateur pour effectuer des recherches de chaînes ne respectant pas la casse.For example, you can use a CaseInsensitiveComparer instance as the comparer to perform case-insensitive string searches.

Si comparer est fourni, les éléments de la List<T> sont comparés à la valeur spécifiée à l’aide de l’implémentation de IComparer<T> spécifiée.If comparer is provided, the elements of the List<T> are compared to the specified value using the specified IComparer<T> implementation.

Si comparer est null, le comparateur par défaut Comparer<T>.Default vérifie si le type T implémente l’interface générique IComparable<T> et utilise cette implémentation, si elle est disponible.If comparer is null, the default comparer Comparer<T>.Default checks whether type T implements the IComparable<T> generic interface and uses that implementation, if available. Si ce n’est pas le cas, Comparer<T>.Default vérifie si le type T implémente l’interface IComparable.If not, Comparer<T>.Default checks whether type T implements the IComparable interface. Si le type T n’implémente aucune interface, Comparer<T>.Default lève InvalidOperationException.If type T does not implement either interface, Comparer<T>.Default throws InvalidOperationException.

Le List<T> doit déjà être trié en fonction de l’implémentation du comparateur ; dans le cas contraire, le résultat est incorrect.The List<T> must already be sorted according to the comparer implementation; otherwise, the result is incorrect.

La comparaison de null avec n’importe quel type référence est autorisée et ne génère pas d’exception lors de l’utilisation de l’interface générique IComparable<T>.Comparing null with any reference type is allowed and does not generate an exception when using the IComparable<T> generic interface. Lors du tri, null est considéré comme inférieur à tout autre objet.When sorting, null is considered to be less than any other object.

Si le List<T> contient plus d’un élément avec la même valeur, la méthode ne retourne qu’une seule occurrence, et peut retourner l’une des occurrences, pas nécessairement la première.If the List<T> contains more than one element with the same value, the method returns only one of the occurrences, and it might return any one of the occurrences, not necessarily the first one.

Si le List<T> ne contient pas la valeur spécifiée, la méthode retourne un entier négatif.If the List<T> does not contain the specified value, the method returns a negative integer. Vous pouvez appliquer l’opération de complément au niveau du bit (~) à cet entier négatif pour récupérer l’index du premier élément supérieur à la valeur de recherche.You can apply the bitwise complement operation (~) to this negative integer to get the index of the first element that is larger than the search value. Lors de l’insertion de la valeur dans le List<T>, cet index doit être utilisé comme point d’insertion pour conserver l’ordre de tri.When inserting the value into the List<T>, this index should be used as the insertion point to maintain the sort order.

Cette méthode est une opération O (log n), où n est le nombre d’éléments de la plage.This method is an O(log n) operation, where n is the number of elements in the range.

Voir aussi

BinarySearch(Int32, Int32, T, IComparer<T>)

Recherche un élément utilisant le comparateur spécifié dans une plage d'éléments du List<T> trié et retourne l'index de base zéro de l'élément.Searches a range of elements in the sorted List<T> for an element using the specified comparer and returns the zero-based index of the element.

public:
 int BinarySearch(int index, int count, T item, System::Collections::Generic::IComparer<T> ^ comparer);
public int BinarySearch (int index, int count, T item, System.Collections.Generic.IComparer<T> comparer);
member this.BinarySearch : int * int * 'T * System.Collections.Generic.IComparer<'T> -> int
Public Function BinarySearch (index As Integer, count As Integer, item As T, comparer As IComparer(Of T)) As Integer

Paramètres

index
Int32

Index de début de base zéro de la plage dans laquelle effectuer la recherche.The zero-based starting index of the range to search.

count
Int32

Longueur de la plage dans laquelle effectuer la recherche.The length of the range to search.

item
T

Objet à trouver.The object to locate. La valeur peut être null pour les types référence.The value can be null for reference types.

comparer
IComparer<T>

Implémentation de IComparer<T> à utiliser pendant la comparaison d'éléments, ou null pour utiliser le comparateur par défaut Default.The IComparer<T> implementation to use when comparing elements, or null to use the default comparer Default.

Retours

Index de base zéro de item dans le List<T> trié, si item existe ; sinon, un nombre négatif qui est le complément de bits de l'index de l'élément suivant supérieur à item ou, s'il n'existe aucun élément supérieur, le complément de bits de Count.The zero-based index of item in the sorted List<T>, if item is found; otherwise, a negative number that is the bitwise complement of the index of the next element that is larger than item or, if there is no larger element, the bitwise complement of Count.

Exceptions

index est inférieur à 0.index is less than 0.

-ou--or- count est inférieur à 0.count is less than 0.

index et count ne désignent pas une plage valide dans List<T>.index and count do not denote a valid range in the List<T>.

comparer est null, et le comparateur par défaut Default ne peut pas trouver une implémentation de l’interface générique IComparable<T> ou de l’interface IComparable pour le type T.comparer is null, and the default comparer Default cannot find an implementation of the IComparable<T> generic interface or the IComparable interface for type T.

Exemples

L’exemple suivant illustre la surcharge de méthode Sort(Int32, Int32, IComparer<T>) et la surcharge de méthode BinarySearch(Int32, Int32, T, IComparer<T>).The following example demonstrates the Sort(Int32, Int32, IComparer<T>) method overload and the BinarySearch(Int32, Int32, T, IComparer<T>) method overload.

L’exemple définit un autre comparateur pour les chaînes nommées DinoCompare, qui implémente le IComparer<string> (IComparer(Of String) dans Visual Basic, C++IComparer<String^> en visuel) interface générique.The example defines an alternative comparer for strings named DinoCompare, which implements the IComparer<string> (IComparer(Of String) in Visual Basic, IComparer<String^> in Visual C++) generic interface. Le comparateur fonctionne comme suit : tout d’abord, les comparateurs sont testés pour null, et une référence null est traitée comme inférieure à une valeur non null.The comparer works as follows: First, the comparands are tested for null, and a null reference is treated as less than a non-null. Deuxièmement, les longueurs de chaîne sont comparées et la chaîne la plus longue est considérée comme supérieure.Second, the string lengths are compared, and the longer string is deemed to be greater. Troisièmement, si les longueurs sont égales, la comparaison de chaînes ordinaire est utilisée.Third, if the lengths are equal, ordinary string comparison is used.

Une List<T> de chaînes est créée et remplie avec les noms de cinq dinosaures herbivorous et trois dinosaures carnivores.A List<T> of strings is created and populated with the names of five herbivorous dinosaurs and three carnivorous dinosaurs. Dans chacun des deux groupes, les noms ne sont pas dans un ordre de tri particulier.Within each of the two groups, the names are not in any particular sort order. La liste s’affiche, la plage de herbivores est triée à l’aide de l’autre comparateur, et la liste s’affiche à nouveau.The list is displayed, the range of herbivores is sorted using the alternate comparer, and the list is displayed again.

La surcharge de méthode BinarySearch(Int32, Int32, T, IComparer<T>) est ensuite utilisée pour rechercher uniquement la plage de herbivores pour « Brachiosaurus ».The BinarySearch(Int32, Int32, T, IComparer<T>) method overload is then used to search only the range of herbivores for "Brachiosaurus". La chaîne est introuvable et le complément au niveau du bit (opérateur C# ~ dans C++et Visual, Xor-1 en Visual Basic) du nombre négatif retourné par la méthode BinarySearch(Int32, Int32, T, IComparer<T>) est utilisé comme index pour l’insertion de la nouvelle chaîne.The string is not found, and the bitwise complement (the ~ operator in C# and Visual C++, Xor -1 in Visual Basic) of the negative number returned by the BinarySearch(Int32, Int32, T, IComparer<T>) method is used as an index for inserting the new string.

using namespace System;
using namespace System::Collections::Generic;

public ref class DinoComparer: IComparer<String^>
{
public:
    virtual int Compare(String^ x, String^ y)
    {
        if (x == nullptr)
        {
            if (y == nullptr)
            {
                // If x is null and y is null, they're
                // equal. 
                return 0;
            }
            else
            {
                // If x is null and y is not null, y
                // is greater. 
                return -1;
            }
        }
        else
        {
            // If x is not null...
            //
            if (y == nullptr)
                // ...and y is null, x is greater.
            {
                return 1;
            }
            else
            {
                // ...and y is not null, compare the 
                // lengths of the two strings.
                //
                int retval = x->Length.CompareTo(y->Length);

                if (retval != 0)
                {
                    // If the strings are not of equal length,
                    // the longer string is greater.
                    //
                    return retval;
                }
                else
                {
                    // If the strings are of equal length,
                    // sort them with ordinary string comparison.
                    //
                    return x->CompareTo(y);
                }
            }
        }
    }
};

void Display(List<String^>^ list)
{
    Console::WriteLine();
    for each(String^ s in list)
    {
        Console::WriteLine(s);
    }
};

void main()
{
    List<String^>^ dinosaurs = gcnew List<String^>();

    dinosaurs->Add("Pachycephalosaurus");
    dinosaurs->Add("Parasauralophus");
    dinosaurs->Add("Amargasaurus");
    dinosaurs->Add("Galimimus");
    dinosaurs->Add("Mamenchisaurus");
    dinosaurs->Add("Deinonychus");
    dinosaurs->Add("Oviraptor");
    dinosaurs->Add("Tyrannosaurus");

    int herbivores = 5;
    Display(dinosaurs);

    DinoComparer^ dc = gcnew DinoComparer();

    Console::WriteLine("\nSort a range with the alternate comparer:");
    dinosaurs->Sort(0, herbivores, dc);
    Display(dinosaurs);

    Console::WriteLine("\nBinarySearch a range and Insert \"{0}\":",
            "Brachiosaurus");

    int index = dinosaurs->BinarySearch(0, herbivores, "Brachiosaurus", dc);

    if (index < 0)
    {
        dinosaurs->Insert(~index, "Brachiosaurus");
        herbivores++;
    }

    Display(dinosaurs);
}

/* This code example produces the following output:

Pachycephalosaurus
Parasauralophus
Amargasaurus
Galimimus
Mamenchisaurus
Deinonychus
Oviraptor
Tyrannosaurus

Sort a range with the alternate comparer:

Galimimus
Amargasaurus
Mamenchisaurus
Parasauralophus
Pachycephalosaurus
Deinonychus
Oviraptor
Tyrannosaurus

BinarySearch a range and Insert "Brachiosaurus":

Galimimus
Amargasaurus
Brachiosaurus
Mamenchisaurus
Parasauralophus
Pachycephalosaurus
Deinonychus
Oviraptor
Tyrannosaurus
 */
using System;
using System.Collections.Generic;

public class DinoComparer: IComparer<string>
{
    public int Compare(string x, string y)
    {
        if (x == null)
        {
            if (y == null)
            {
                // If x is null and y is null, they're
                // equal. 
                return 0;
            }
            else
            {
                // If x is null and y is not null, y
                // is greater. 
                return -1;
            }
        }
        else
        {
            // If x is not null...
            //
            if (y == null)
                // ...and y is null, x is greater.
            {
                return 1;
            }
            else
            {
                // ...and y is not null, compare the 
                // lengths of the two strings.
                //
                int retval = x.Length.CompareTo(y.Length);

                if (retval != 0)
                {
                    // If the strings are not of equal length,
                    // the longer string is greater.
                    //
                    return retval;
                }
                else
                {
                    // If the strings are of equal length,
                    // sort them with ordinary string comparison.
                    //
                    return x.CompareTo(y);
                }
            }
        }
    }
}

public class Example
{
    public static void Main()
    {
        List<string> dinosaurs = new List<string>();

        dinosaurs.Add("Pachycephalosaurus");
        dinosaurs.Add("Parasauralophus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("Galimimus");
        dinosaurs.Add("Mamenchisaurus");
        dinosaurs.Add("Deinonychus");
        dinosaurs.Add("Oviraptor");
        dinosaurs.Add("Tyrannosaurus");

        int herbivores = 5;
        Display(dinosaurs);

        DinoComparer dc = new DinoComparer();

        Console.WriteLine("\nSort a range with the alternate comparer:");
        dinosaurs.Sort(0, herbivores, dc);
        Display(dinosaurs);

        Console.WriteLine("\nBinarySearch a range and Insert \"{0}\":",
            "Brachiosaurus");

        int index = dinosaurs.BinarySearch(0, herbivores, "Brachiosaurus", dc);

        if (index < 0)
        {
            dinosaurs.Insert(~index, "Brachiosaurus");
            herbivores++;
        }

        Display(dinosaurs);
    }

    private static void Display(List<string> list)
    {
        Console.WriteLine();
        foreach( string s in list )
        {
            Console.WriteLine(s);
        }
    }
}

/* This code example produces the following output:

Pachycephalosaurus
Parasauralophus
Amargasaurus
Galimimus
Mamenchisaurus
Deinonychus
Oviraptor
Tyrannosaurus

Sort a range with the alternate comparer:

Galimimus
Amargasaurus
Mamenchisaurus
Parasauralophus
Pachycephalosaurus
Deinonychus
Oviraptor
Tyrannosaurus

BinarySearch a range and Insert "Brachiosaurus":

Galimimus
Amargasaurus
Brachiosaurus
Mamenchisaurus
Parasauralophus
Pachycephalosaurus
Deinonychus
Oviraptor
Tyrannosaurus
 */
Imports System.Collections.Generic

Public Class DinoComparer
    Implements IComparer(Of String)

    Public Function Compare(ByVal x As String, _
        ByVal y As String) As Integer _
        Implements IComparer(Of String).Compare

        If x Is Nothing Then
            If y Is Nothing Then 
                ' If x is Nothing and y is Nothing, they're
                ' equal. 
                Return 0
            Else
                ' If x is Nothing and y is not Nothing, y
                ' is greater. 
                Return -1
            End If
        Else
            ' If x is not Nothing...
            '
            If y Is Nothing Then
                ' ...and y is Nothing, x is greater.
                Return 1
            Else
                ' ...and y is not Nothing, compare the 
                ' lengths of the two strings.
                '
                Dim retval As Integer = _
                    x.Length.CompareTo(y.Length)

                If retval <> 0 Then 
                    ' If the strings are not of equal length,
                    ' the longer string is greater.
                    '
                    Return retval
                Else
                    ' If the strings are of equal length,
                    ' sort them with ordinary string comparison.
                    '
                    Return x.CompareTo(y)
                End If
            End If
        End If
    End Function
End Class

Public Class Example

    Public Shared Sub Main()

        Dim dinosaurs As New List(Of String)

        dinosaurs.Add("Pachycephalosaurus")
        dinosaurs.Add("Parasauralophus")
        dinosaurs.Add("Amargasaurus")
        dinosaurs.Add("Galimimus")
        dinosaurs.Add("Mamenchisaurus")
        dinosaurs.Add("Deinonychus")
        dinosaurs.Add("Oviraptor")
        dinosaurs.Add("Tyrannosaurus")

        Dim herbivores As Integer = 5
        Display(dinosaurs)

        Dim dc As New DinoComparer

        Console.WriteLine(vbLf & _
            "Sort a range with the alternate comparer:")
        dinosaurs.Sort(0, herbivores, dc)
        Display(dinosaurs)

        Console.WriteLine(vbLf & _
            "BinarySearch a range and Insert ""{0}"":", _
            "Brachiosaurus")

        Dim index As Integer = _
            dinosaurs.BinarySearch(0, herbivores, "Brachiosaurus", dc)

        If index < 0 Then
            index = index Xor -1
            dinosaurs.Insert(index, "Brachiosaurus")
            herbivores += 1
        End If

        Display(dinosaurs)

    End Sub

    Private Shared Sub Display(ByVal lis As List(Of String))
        Console.WriteLine()
        For Each s As String In lis
            Console.WriteLine(s)
        Next
    End Sub
End Class

' This code example produces the following output:
'
'Pachycephalosaurus
'Parasauralophus
'Amargasaurus
'Galimimus
'Mamenchisaurus
'Deinonychus
'Oviraptor
'Tyrannosaurus
'
'Sort a range with the alternate comparer:
'
'Galimimus
'Amargasaurus
'Mamenchisaurus
'Parasauralophus
'Pachycephalosaurus
'Deinonychus
'Oviraptor
'Tyrannosaurus
'
'BinarySearch a range and Insert "Brachiosaurus":
'
'Galimimus
'Amargasaurus
'Brachiosaurus
'Mamenchisaurus
'Parasauralophus
'Pachycephalosaurus
'Deinonychus
'Oviraptor
'Tyrannosaurus

Remarques

Le comparateur personnalise la manière dont les éléments sont comparés.The comparer customizes how the elements are compared. Par exemple, vous pouvez utiliser une instance de CaseInsensitiveComparer comme comparateur pour effectuer des recherches de chaînes ne respectant pas la casse.For example, you can use a CaseInsensitiveComparer instance as the comparer to perform case-insensitive string searches.

Si comparer est fourni, les éléments de la List<T> sont comparés à la valeur spécifiée à l’aide de l’implémentation de IComparer<T> spécifiée.If comparer is provided, the elements of the List<T> are compared to the specified value using the specified IComparer<T> implementation.

Si comparer est null, le comparateur par défaut Comparer<T>.Default vérifie si le type T implémente l’interface générique IComparable<T> et utilise cette implémentation, si elle est disponible.If comparer is null, the default comparer Comparer<T>.Default checks whether type T implements the IComparable<T> generic interface and uses that implementation, if available. Si ce n’est pas le cas, Comparer<T>.Default vérifie si le type T implémente l’interface IComparable.If not, Comparer<T>.Default checks whether type T implements the IComparable interface. Si le type T n’implémente aucune interface, Comparer<T>.Default lève InvalidOperationException.If type T does not implement either interface, Comparer<T>.Default throws InvalidOperationException.

Le List<T> doit déjà être trié en fonction de l’implémentation du comparateur ; dans le cas contraire, le résultat est incorrect.The List<T> must already be sorted according to the comparer implementation; otherwise, the result is incorrect.

La comparaison de null avec n’importe quel type référence est autorisée et ne génère pas d’exception lors de l’utilisation de l’interface générique IComparable<T>.Comparing null with any reference type is allowed and does not generate an exception when using the IComparable<T> generic interface. Lors du tri, null est considéré comme inférieur à tout autre objet.When sorting, null is considered to be less than any other object.

Si le List<T> contient plus d’un élément avec la même valeur, la méthode ne retourne qu’une seule occurrence, et peut retourner l’une des occurrences, pas nécessairement la première.If the List<T> contains more than one element with the same value, the method returns only one of the occurrences, and it might return any one of the occurrences, not necessarily the first one.

Si le List<T> ne contient pas la valeur spécifiée, la méthode retourne un entier négatif.If the List<T> does not contain the specified value, the method returns a negative integer. Vous pouvez appliquer l’opération de complément au niveau du bit (~) à cet entier négatif pour récupérer l’index du premier élément supérieur à la valeur de recherche.You can apply the bitwise complement operation (~) to this negative integer to get the index of the first element that is larger than the search value. Lors de l’insertion de la valeur dans le List<T>, cet index doit être utilisé comme point d’insertion pour conserver l’ordre de tri.When inserting the value into the List<T>, this index should be used as the insertion point to maintain the sort order.

Cette méthode est une opération O (log n), où n est le nombre d’éléments de la plage.This method is an O(log n) operation, where n is the number of elements in the range.

Voir aussi

S’applique à