List<T>.BinarySearch List<T>.BinarySearch List<T>.BinarySearch List<T>.BinarySearch Method

Definição

Usa um algoritmo de pesquisa binária para localizar um elemento específico no List<T> classificado ou parte dele.Uses a binary search algorithm to locate a specific element in the sorted List<T> or a portion of it.

Sobrecargas

BinarySearch(T) BinarySearch(T) BinarySearch(T) BinarySearch(T)

Pesquisa todo o List<T> classificado para um elemento usando o comparador padrão e retorna o índice baseado em zero do elemento.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>) BinarySearch(T, IComparer<T>) BinarySearch(T, IComparer<T>) BinarySearch(T, IComparer<T>)

Pesquisa um elemento em todo o List<T> classificado usando o comparador especificado e retorna o índice baseado em zero do elemento.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>) BinarySearch(Int32, Int32, T, IComparer<T>) BinarySearch(Int32, Int32, T, IComparer<T>) BinarySearch(Int32, Int32, T, IComparer<T>)

Pesquisa um intervalo de elementos no List<T> classificado para encontrar um elemento que usa o comparador especificado e retorna o índice baseado em zero do elemento.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) BinarySearch(T) BinarySearch(T) BinarySearch(T)

Pesquisa todo o List<T> classificado para um elemento usando o comparador padrão e retorna o índice baseado em zero do elemento.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

Parâmetros

item
T T T T

O objeto a ser localizado.The object to locate. O valor pode ser null para tipos de referência.The value can be null for reference types.

Retornos

O índice baseado em zero da item no List<T> classificado, se item for encontrado; caso contrário, um número negativo que é o complemento bit a bit do índice do próximo elemento maior que item, ou, se não houver nenhum elemento maior, o complemento bit a bit 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.

Exceções

O comparador padrão Default não consegue encontrar uma implementação da interface genérica IComparable<T> ou a interface IComparable para o tipo T.The default comparer Default cannot find an implementation of the IComparable<T> generic interface or the IComparable interface for type T.

Exemplos

O exemplo a seguir demonstra a Sort() sobrecarga de método e o BinarySearch(T) sobrecarga de método.The following example demonstrates the Sort() method overload and the BinarySearch(T) method overload. Um List<T> de cadeias de caracteres é criada e preenchida com quatro cadeias de caracteres, sem nenhuma ordem específica.A List<T> of strings is created and populated with four strings, in no particular order. A lista é exibida, classificada e exibida novamente.The list is displayed, sorted, and displayed again.

O BinarySearch(T) sobrecarga do método é usada para procurar por duas cadeias de caracteres que não estão na lista, e o Insert método é usado para inseri-los.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. O valor de retorno de BinarySearch(T) método é negativo em cada caso, porque as cadeias de caracteres não estão na lista.The return value of the BinarySearch(T) method is negative in each case, because the strings are not in the list. Levando o complemento bit a bit (o ~ operador em c# e Visual C++, Xor -1 no Visual Basic) disso produz número negativo, o índice do primeiro elemento na lista que é maior do que a cadeia de caracteres de pesquisa e inserção neste local preserva a classificação ordem.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. A segunda cadeia de caracteres de pesquisa é maior que qualquer elemento na lista, portanto, a posição de inserção é no final da lista.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
 */
using System;
using System.Collections.Generic;

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");

        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:

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

Comentários

Esse método usa o comparador padrão Comparer<T>.Default para o tipo T para determinar a ordem dos elementos da lista.This method uses the default comparer Comparer<T>.Default for type T to determine the order of list elements. O Comparer<T>.Default verificações de propriedade se tipo T implementa o IComparable<T> interface genérica e usa essa implementação, se disponível.The Comparer<T>.Default property checks whether type T implements the IComparable<T> generic interface and uses that implementation, if available. Caso contrário, Comparer<T>.Default verifica se tipo T implementa o IComparable interface.If not, Comparer<T>.Default checks whether type T implements the IComparable interface. Se tipo T não implementa a interface Comparer<T>.Default lança um InvalidOperationException.If type T does not implement either interface, Comparer<T>.Default throws an InvalidOperationException.

O List<T> já devem ser classificados de acordo com a implementação de comparador; caso contrário, o resultado é incorreto.The List<T> must already be sorted according to the comparer implementation; otherwise, the result is incorrect.

Comparando null com qualquer referência de tipo é permitido e não gera uma exceção ao usar o IComparable<T> interface genérica.Comparing null with any reference type is allowed and does not generate an exception when using the IComparable<T> generic interface. Durante a classificação, null é considerado menor que qualquer outro objeto.When sorting, null is considered to be less than any other object.

Se o List<T> contém mais de um elemento com o mesmo valor, o método retornará somente uma das ocorrências e pode retornar qualquer uma das ocorrências, não necessariamente o primeiro deles.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.

Caso o List<T> não contenha o valor especificado, o método retorna um inteiro negativo.If the List<T> does not contain the specified value, the method returns a negative integer. Você pode aplicar a operação de complemento bit a bit (~) para esse número inteiro negativo para obter o índice do primeiro elemento maior que o valor de pesquisa.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. Ao inserir o valor para o List<T>, esse índice deve ser usado como o ponto de inserção para manter a ordem de classificação.When inserting the value into the List<T>, this index should be used as the insertion point to maintain the sort order.

Esse método é um O (log n) a operação, onde n é o número de elementos no intervalo.This method is an O(log n) operation, where n is the number of elements in the range.

Veja também

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

Pesquisa um elemento em todo o List<T> classificado usando o comparador especificado e retorna o índice baseado em zero do elemento.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

Parâmetros

item
T T T T

O objeto a ser localizado.The object to locate. O valor pode ser null para tipos de referência.The value can be null for reference types.

comparer
IComparer<T> IComparer<T> IComparer<T> IComparer<T>

A implementação de IComparer<T> a ser usada durante a comparação de elementos.The IComparer<T> implementation to use when comparing elements.

- ou --or- null para usar o comparador padrão Default.null to use the default comparer Default.

Retornos

O índice baseado em zero da item no List<T> classificado, se item for encontrado; caso contrário, um número negativo que é o complemento bit a bit do índice do próximo elemento maior que item, ou, se não houver nenhum elemento maior, o complemento bit a bit 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.

Exceções

comparer é null e o comparador padrão Default não consegue encontrar uma implementação da interface genérica IComparable<T> ou a interface IComparable para o tipo 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.

Exemplos

O exemplo a seguir demonstra a Sort(IComparer<T>) sobrecarga de método e o BinarySearch(T, IComparer<T>) sobrecarga de método.The following example demonstrates the Sort(IComparer<T>) method overload and the BinarySearch(T, IComparer<T>) method overload.

O exemplo define uma comparação alternativa para cadeias de caracteres chamado DinoCompare, que implementa o IComparer<string> (IComparer(Of String) no Visual Basic, IComparer<String^> no Visual C++) interface genérica.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. O comparador funciona da seguinte maneira: Primeiro, os termos de comparação são testados para null, e uma referência nula é tratada como menor que um não-nulo.The comparer works as follows: First, the comparands are tested for null, and a null reference is treated as less than a non-null. Em segundo lugar, os comprimentos de cadeia de caracteres são comparados, e a cadeia de caracteres mais é considerada como sendo maior.Second, the string lengths are compared, and the longer string is deemed to be greater. Em terceiro lugar, se os tamanhos forem iguais, a comparação de cadeia de caracteres comum é usada.Third, if the lengths are equal, ordinary string comparison is used.

Um List<T> de cadeias de caracteres é criada e preenchida com quatro cadeias de caracteres, sem nenhuma ordem específica.A List<T> of strings is created and populated with four strings, in no particular order. A lista é exibida, classificada usando o comparador alternativo e exibida novamente.The list is displayed, sorted using the alternate comparer, and displayed again.

O BinarySearch(T, IComparer<T>) sobrecarga do método é usada para pesquisar várias cadeias de caracteres que não estão na lista, empregando o comparador alternativo.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. O Insert método é usado para inserir as cadeias de caracteres.The Insert method is used to insert the strings. Esses dois métodos estão localizados na função nomeada SearchAndInsert, junto com o código para levar o complemento bit a bit (o ~ operador em c# e Visual C++, Xor -1 no Visual Basic) do número negativo retornado por BinarySearch(T, IComparer<T>) e usá-lo como um índice para Inserir nova cadeia de caracteres.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
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

Comentários

A comparação personaliza como os elementos são comparados.The comparer customizes how the elements are compared. Por exemplo, você pode usar um CaseInsensitiveComparer instância como o comparador para executar pesquisas de cadeia de caracteres diferencia maiusculas de minúsculas.For example, you can use a CaseInsensitiveComparer instance as the comparer to perform case-insensitive string searches.

Se comparer for fornecido, os elementos do List<T> são comparados com o valor especificado usando especificado IComparer<T> implementação.If comparer is provided, the elements of the List<T> are compared to the specified value using the specified IComparer<T> implementation.

Se comparer está null, o comparador padrão Comparer<T>.Default verifica se tipo T implementa o IComparable<T> interface genérica e usa essa implementação, se disponível.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. Caso contrário, Comparer<T>.Default verifica se tipo T implementa o IComparable interface.If not, Comparer<T>.Default checks whether type T implements the IComparable interface. Se tipo T não implementa a interface Comparer<T>.Default lança InvalidOperationException.If type T does not implement either interface, Comparer<T>.Default throws InvalidOperationException.

O List<T> já devem ser classificados de acordo com a implementação de comparador; caso contrário, o resultado é incorreto.The List<T> must already be sorted according to the comparer implementation; otherwise, the result is incorrect.

Comparando null com qualquer referência de tipo é permitido e não gera uma exceção ao usar o IComparable<T> interface genérica.Comparing null with any reference type is allowed and does not generate an exception when using the IComparable<T> generic interface. Durante a classificação, null é considerado menor que qualquer outro objeto.When sorting, null is considered to be less than any other object.

Se o List<T> contém mais de um elemento com o mesmo valor, o método retornará somente uma das ocorrências e pode retornar qualquer uma das ocorrências, não necessariamente o primeiro deles.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.

Caso o List<T> não contenha o valor especificado, o método retorna um inteiro negativo.If the List<T> does not contain the specified value, the method returns a negative integer. Você pode aplicar a operação de complemento bit a bit (~) para esse número inteiro negativo para obter o índice do primeiro elemento maior que o valor de pesquisa.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. Ao inserir o valor para o List<T>, esse índice deve ser usado como o ponto de inserção para manter a ordem de classificação.When inserting the value into the List<T>, this index should be used as the insertion point to maintain the sort order.

Esse método é um O (log n) a operação, onde n é o número de elementos no intervalo.This method is an O(log n) operation, where n is the number of elements in the range.

Veja também

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

Pesquisa um intervalo de elementos no List<T> classificado para encontrar um elemento que usa o comparador especificado e retorna o índice baseado em zero do elemento.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

Parâmetros

index
Int32 Int32 Int32 Int32

O índice baseado em zero inicial do intervalo a ser pesquisado.The zero-based starting index of the range to search.

count
Int32 Int32 Int32 Int32

O tamanho do intervalo a ser procurado.The length of the range to search.

item
T T T T

O objeto a ser localizado.The object to locate. O valor pode ser null para tipos de referência.The value can be null for reference types.

comparer
IComparer<T> IComparer<T> IComparer<T> IComparer<T>

A implementação IComparer<T> a ser usada na comparação de elementos ou null para usar o comparador padrão Default.The IComparer<T> implementation to use when comparing elements, or null to use the default comparer Default.

Retornos

O índice baseado em zero da item no List<T> classificado, se item for encontrado; caso contrário, um número negativo que é o complemento bit a bit do índice do próximo elemento maior que item, ou, se não houver nenhum elemento maior, o complemento bit a bit 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.

Exceções

index é menor que 0.index is less than 0.

- ou --or- count é menor que 0.count is less than 0.

index e count não denotam um intervalo válido em List<T>.index and count do not denote a valid range in the List<T>.

comparer é null e o comparador padrão Default não consegue encontrar uma implementação da interface genérica IComparable<T> ou a interface IComparable para o tipo 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.

Exemplos

O exemplo a seguir demonstra a Sort(Int32, Int32, IComparer<T>) sobrecarga de método e o BinarySearch(Int32, Int32, T, IComparer<T>) sobrecarga de método.The following example demonstrates the Sort(Int32, Int32, IComparer<T>) method overload and the BinarySearch(Int32, Int32, T, IComparer<T>) method overload.

O exemplo define uma comparação alternativa para cadeias de caracteres chamado DinoCompare, que implementa o IComparer<string> (IComparer(Of String) no Visual Basic, IComparer<String^> no Visual C++) interface genérica.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. O comparador funciona da seguinte maneira: Primeiro, os termos de comparação são testados para null, e uma referência nula é tratada como menor que um não-nulo.The comparer works as follows: First, the comparands are tested for null, and a null reference is treated as less than a non-null. Em segundo lugar, os comprimentos de cadeia de caracteres são comparados, e a cadeia de caracteres mais é considerada como sendo maior.Second, the string lengths are compared, and the longer string is deemed to be greater. Em terceiro lugar, se os tamanhos forem iguais, a comparação de cadeia de caracteres comum é usada.Third, if the lengths are equal, ordinary string comparison is used.

Um List<T> de cadeias de caracteres é criada e preenchida com os nomes de dinossauros herbivorous cinco e três dinossauros carnivorous.A List<T> of strings is created and populated with the names of five herbivorous dinosaurs and three carnivorous dinosaurs. Dentro de cada um dos dois grupos, os nomes não são em qualquer ordem de classificação específico.Within each of the two groups, the names are not in any particular sort order. A lista é exibida, o intervalo de herbivores é classificado usando o comparador alternativo e a lista é exibida novamente.The list is displayed, the range of herbivores is sorted using the alternate comparer, and the list is displayed again.

O BinarySearch(Int32, Int32, T, IComparer<T>) sobrecarga do método é usada para pesquisar somente o intervalo de herbivores "Brachiosaurus".The BinarySearch(Int32, Int32, T, IComparer<T>) method overload is then used to search only the range of herbivores for "Brachiosaurus". A cadeia de caracteres não for encontrada e o complemento bit a bit (o ~ operador em c# e Visual C++, Xor -1 no Visual Basic) do número negativo retornado pelo BinarySearch(Int32, Int32, T, IComparer<T>) método é usado como um índice para a nova cadeia de caracteres de inserção.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
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

Comentários

A comparação personaliza como os elementos são comparados.The comparer customizes how the elements are compared. Por exemplo, você pode usar um CaseInsensitiveComparer instância como o comparador para executar pesquisas de cadeia de caracteres diferencia maiusculas de minúsculas.For example, you can use a CaseInsensitiveComparer instance as the comparer to perform case-insensitive string searches.

Se comparer for fornecido, os elementos do List<T> são comparados com o valor especificado usando especificado IComparer<T> implementação.If comparer is provided, the elements of the List<T> are compared to the specified value using the specified IComparer<T> implementation.

Se comparer está null, o comparador padrão Comparer<T>.Default verifica se tipo T implementa o IComparable<T> interface genérica e usa essa implementação, se disponível.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. Caso contrário, Comparer<T>.Default verifica se tipo T implementa o IComparable interface.If not, Comparer<T>.Default checks whether type T implements the IComparable interface. Se tipo T não implementa a interface Comparer<T>.Default lança InvalidOperationException.If type T does not implement either interface, Comparer<T>.Default throws InvalidOperationException.

O List<T> já devem ser classificados de acordo com a implementação de comparador; caso contrário, o resultado é incorreto.The List<T> must already be sorted according to the comparer implementation; otherwise, the result is incorrect.

Comparando null com qualquer referência de tipo é permitido e não gera uma exceção ao usar o IComparable<T> interface genérica.Comparing null with any reference type is allowed and does not generate an exception when using the IComparable<T> generic interface. Durante a classificação, null é considerado menor que qualquer outro objeto.When sorting, null is considered to be less than any other object.

Se o List<T> contém mais de um elemento com o mesmo valor, o método retornará somente uma das ocorrências e pode retornar qualquer uma das ocorrências, não necessariamente o primeiro deles.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.

Caso o List<T> não contenha o valor especificado, o método retorna um inteiro negativo.If the List<T> does not contain the specified value, the method returns a negative integer. Você pode aplicar a operação de complemento bit a bit (~) para esse número inteiro negativo para obter o índice do primeiro elemento maior que o valor de pesquisa.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. Ao inserir o valor para o List<T>, esse índice deve ser usado como o ponto de inserção para manter a ordem de classificação.When inserting the value into the List<T>, this index should be used as the insertion point to maintain the sort order.

Esse método é um O (log n) a operação, onde n é o número de elementos no intervalo.This method is an O(log n) operation, where n is the number of elements in the range.

Veja também

Aplica-se a