Udostępnij za pośrednictwem

List<T>.BinarySearch Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Collections.Generic
Zestaw:
System.Collections.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Używa algorytmu wyszukiwania binarnego do lokalizowania określonego elementu w posortowanej List<T> lub części.

Przeciążenia

BinarySearch(T)

Wyszukuje cały posortowany List<T> element przy użyciu domyślnego porównania i zwraca indeks zerowy elementu.
BinarySearch(T, IComparer<T>)

Wyszukuje cały posortowany List<T> element przy użyciu określonego porównania i zwraca indeks zerowy elementu.
BinarySearch(Int32, Int32, T, IComparer<T>)

Wyszukuje zakres elementów w posortowanym List<T> dla elementu przy użyciu określonego modułu porównującego i zwraca indeks zerowy elementu.

BinarySearch(T)

Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs

Wyszukuje cały posortowany List<T> element przy użyciu domyślnego porównania i zwraca indeks zerowy elementu.

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

Parametry

item
T

Obiekt do zlokalizowania. Wartość może być null dla typów referencyjnych.

Zwraca

Int32

Indeks item oparty na zera w posortowanym List<T>obiekcie , jeśli item zostanie znaleziony; w przeciwnym razie ujemna liczba, która jest bitowym uzupełnieniem indeksu następnego elementu, który jest większy niż item lub, jeśli nie ma większego elementu, bitowe uzupełnienie elementu Count.

Wyjątki

InvalidOperationException

Domyślny moduł porównujący Default nie może odnaleźć implementacji interfejsu IComparable<T> ogólnego lub interfejsu IComparable dla typu T.

Przykłady

W poniższym przykładzie pokazano Sort() przeciążenie metody i BinarySearch(T) przeciążenie metody. Ciągi List<T> są tworzone i wypełniane czterema ciągami, bez określonej kolejności. Lista jest wyświetlana, posortowana i wyświetlana ponownie.

BinarySearch(T) Przeciążenie metody jest następnie używane do wyszukiwania dwóch ciągów, które nie znajdują się na liście, a Insert metoda jest używana do ich wstawiania. Zwracana wartość BinarySearch(T) metody jest ujemna w każdym przypadku, ponieważ ciągi nie znajdują się na liście. Biorąc bitowe uzupełnienie (operator ~ w językach C# i Visual C++, Xor -1 w Języku Visual Basic) tej liczby ujemnej tworzy indeks pierwszego elementu na liście, który jest większy niż ciąg wyszukiwania, a wstawianie w tej lokalizacji zachowuje kolejność sortowania. Drugi ciąg wyszukiwania jest większy niż dowolny element na liście, więc pozycja wstawiania znajduje się na końcu listy.

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

Uwagi

Ta metoda używa domyślnego modułu porównującego Comparer<T>.Default dla typu T w celu określenia kolejności elementów listy. Właściwość Comparer<T>.Default sprawdza, czy typ T implementuje IComparable<T> interfejs ogólny i używa tej implementacji, jeśli jest dostępna. Jeśli nie, sprawdza, Comparer<T>.Default czy typ T implementuje IComparable interfejs. Jeśli typ T nie implementuje interfejsu, Comparer<T>.Default zgłasza wartość InvalidOperationException.

Element List<T> musi być już posortowany zgodnie z implementacją modułu porównania. W przeciwnym razie wynik jest niepoprawny.

Porównanie null z dowolnym typem referencyjnym jest dozwolone i nie generuje wyjątku podczas korzystania z interfejsu IComparable<T> ogólnego. Podczas sortowania uważa się, null że jest on mniejszy niż jakikolwiek inny obiekt.

Jeśli element List<T> zawiera więcej niż jeden element o tej samej wartości, metoda zwraca tylko jedno z wystąpień i może zwrócić dowolne z wystąpień, niekoniecznie pierwsze.

Jeśli parametr List<T> nie zawiera określonej wartości, metoda zwraca ujemną liczbę całkowitą. Możesz zastosować operację uzupełniania bitowego (~) do tej ujemnej liczby całkowitej, aby uzyskać indeks pierwszego elementu, który jest większy niż wartość wyszukiwania. Podczas wstawiania wartości do List<T>klasy należy użyć tego indeksu jako punktu wstawiania, aby zachować kolejność sortowania.

Ta metoda jest operacją O(log n), gdzie n jest liczbą elementów w zakresie.

Zobacz też

Dotyczy

BinarySearch(T, IComparer<T>)

Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs

Wyszukuje cały posortowany List<T> element przy użyciu określonego porównania i zwraca indeks zerowy elementu.

public:
 int BinarySearch(T item, System::Collections::Generic::IComparer<T> ^ comparer);
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

Parametry

item
T

Obiekt do zlokalizowania. Wartość może być null dla typów referencyjnych.

comparer
IComparer<T>

Implementacja IComparer<T> do użycia podczas porównywania elementów.

-lub-

null aby użyć domyślnego porównującego Default.

Zwraca

Int32

Indeks item oparty na zera w posortowanym List<T>obiekcie , jeśli item zostanie znaleziony; w przeciwnym razie ujemna liczba, która jest bitowym uzupełnieniem indeksu następnego elementu, który jest większy niż item lub, jeśli nie ma większego elementu, bitowe uzupełnienie elementu Count.

Wyjątki

InvalidOperationException

comparer to null, a domyślny moduł porównujący Default nie może odnaleźć implementacji interfejsu IComparable<T> ogólnego lub interfejsu IComparable dla typu T.

Przykłady

W poniższym przykładzie pokazano Sort(IComparer<T>) przeciążenie metody i BinarySearch(T, IComparer<T>) przeciążenie metody.

W przykładzie zdefiniowano alternatywny moduł porównujący ciągów o nazwie DinoCompare, który implementuje IComparer<string> interfejs ogólny (IComparer(Of String) w języku Visual Basic IComparer<String^> w języku Visual C++). Narzędzie porównujące działa w następujący sposób: najpierw współzależność jest testowana pod kątem nullwartości , a odwołanie o wartości null jest traktowane jako mniejsze niż niepuste. Po drugie, długości ciągów są porównywane, a dłuższy ciąg jest uznawany za większy. Po trzecie, jeśli długości są równe, używane jest zwykłe porównanie ciągów.

Ciągi List<T> są tworzone i wypełniane czterema ciągami, bez określonej kolejności. Zostanie wyświetlona lista, posortowana przy użyciu alternatywnego porównania i wyświetlona ponownie.

BinarySearch(T, IComparer<T>) Przeciążenie metody jest następnie używane do wyszukiwania kilku ciągów, które nie znajdują się na liście, przy użyciu alternatywnego porównania. Metoda Insert służy do wstawiania ciągów. Te dwie metody znajdują się w funkcji o nazwie SearchAndInsert, wraz z kodem, aby pobrać bitowe uzupełnienie (operator ~ w języku C# i Visual C++, Xor -1 w Visual Basic) liczby ujemnej zwracanej przez BinarySearch(T, IComparer<T>) i używać jej jako indeksu do wstawiania nowego ciągu.

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

Uwagi

Moduł porównujący dostosowuje sposób porównywania elementów. Na przykład możesz użyć wystąpienia jako porównującego CaseInsensitiveComparer , aby wykonać wyszukiwanie ciągów bez uwzględniania wielkości liter.

Jeśli comparer zostanie podana wartość , elementy List<T> są porównywane z określoną wartością przy użyciu określonej IComparer<T> implementacji.

Jeśli comparer to null, domyślny moduł porównujący Comparer<T>.Default sprawdza, czy typ T implementuje IComparable<T> interfejs ogólny i używa tej implementacji, jeśli jest dostępna. Jeśli nie, sprawdza, Comparer<T>.Default czy typ T implementuje IComparable interfejs. Jeśli typ T nie implementuje interfejsu, Comparer<T>.Default zwraca wartość InvalidOperationException.

Element List<T> musi być już posortowany zgodnie z implementacją modułu porównania. W przeciwnym razie wynik jest niepoprawny.

Porównanie null z dowolnym typem referencyjnym jest dozwolone i nie generuje wyjątku podczas korzystania z interfejsu IComparable<T> ogólnego. Podczas sortowania uważa się, null że jest on mniejszy niż jakikolwiek inny obiekt.

Jeśli element List<T> zawiera więcej niż jeden element o tej samej wartości, metoda zwraca tylko jedno z wystąpień i może zwrócić dowolne z wystąpień, niekoniecznie pierwsze.

Jeśli parametr List<T> nie zawiera określonej wartości, metoda zwraca ujemną liczbę całkowitą. Możesz zastosować operację uzupełniania bitowego (~) do tej ujemnej liczby całkowitej, aby uzyskać indeks pierwszego elementu, który jest większy niż wartość wyszukiwania. Podczas wstawiania wartości do List<T>klasy należy użyć tego indeksu jako punktu wstawiania, aby zachować kolejność sortowania.

Ta metoda jest operacją O(log n), gdzie n jest liczbą elementów w zakresie.

Zobacz też

Dotyczy

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

Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs

Wyszukuje zakres elementów w posortowanym List<T> dla elementu przy użyciu określonego modułu porównującego i zwraca indeks zerowy elementu.

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

Parametry

index
Int32

Zerowy indeks początkowy zakresu do wyszukania.

count
Int32

Długość zakresu wyszukiwania.

item
T

Obiekt do zlokalizowania. Wartość może być null dla typów referencyjnych.

comparer
IComparer<T>

Implementacja IComparer<T> używana podczas porównywania elementów lub null używania domyślnego modułu Defaultporównującego .

Zwraca

Int32

Indeks item oparty na zera w posortowanym List<T>obiekcie , jeśli item zostanie znaleziony; w przeciwnym razie ujemna liczba, która jest bitowym uzupełnieniem indeksu następnego elementu, który jest większy niż item lub, jeśli nie ma większego elementu, bitowe uzupełnienie elementu Count.

Wyjątki

ArgumentOutOfRangeException

index wartość jest mniejsza niż 0.

-lub-

count wartość jest mniejsza niż 0.

ArgumentException

index i count nie oznaczają prawidłowego zakresu w obiekcie List<T>.

InvalidOperationException

comparer to null, a domyślny moduł porównujący Default nie może odnaleźć implementacji interfejsu IComparable<T> ogólnego lub interfejsu IComparable dla typu T.

Przykłady

W poniższym przykładzie pokazano Sort(Int32, Int32, IComparer<T>) przeciążenie metody i BinarySearch(Int32, Int32, T, IComparer<T>) przeciążenie metody.

W przykładzie zdefiniowano alternatywny moduł porównujący ciągów o nazwie DinoCompare, który implementuje IComparer<string> interfejs ogólny (IComparer(Of String) w języku Visual Basic IComparer<String^> w języku Visual C++). Narzędzie porównujące działa w następujący sposób: najpierw współzależność jest testowana pod kątem nullwartości , a odwołanie o wartości null jest traktowane jako mniejsze niż niepuste. Po drugie, długości ciągów są porównywane, a dłuższy ciąg jest uznawany za większy. Po trzecie, jeśli długości są równe, używane jest zwykłe porównanie ciągów.

Ciągi List<T> są tworzone i wypełniane nazwami pięciu roślinożernych dinozaurów i trzech mięsożernych dinozaurów. W każdej z tych dwóch grup nazwy nie są w żadnej określonej kolejności sortowania. Zostanie wyświetlona lista, zakres herbyworów jest posortowany przy użyciu alternatywnego porównania, a lista jest wyświetlana ponownie.

BinarySearch(Int32, Int32, T, IComparer<T>) Przeciążenie metody jest następnie używane do wyszukiwania tylko zakresu herbiwarów dla "Brachiosaurus". Nie można odnaleźć ciągu, a dopełnienie bitowe (operator ~ w językach C# i Visual C++, Xor -1 w Języku Visual Basic) liczby ujemnej zwracanej przez BinarySearch(Int32, Int32, T, IComparer<T>) metodę jest używany jako indeks do wstawiania nowego ciągu.

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

Uwagi

Moduł porównujący dostosowuje sposób porównywania elementów. Na przykład możesz użyć wystąpienia jako porównującego CaseInsensitiveComparer , aby wykonać wyszukiwanie ciągów bez uwzględniania wielkości liter.

Jeśli comparer zostanie podana wartość , elementy List<T> są porównywane z określoną wartością przy użyciu określonej IComparer<T> implementacji.

Jeśli comparer to null, domyślny moduł porównujący Comparer<T>.Default sprawdza, czy typ T implementuje IComparable<T> interfejs ogólny i używa tej implementacji, jeśli jest dostępna. Jeśli nie, sprawdza, Comparer<T>.Default czy typ T implementuje IComparable interfejs. Jeśli typ T nie implementuje interfejsu, Comparer<T>.Default zwraca wartość InvalidOperationException.

Element List<T> musi być już posortowany zgodnie z implementacją modułu porównania. W przeciwnym razie wynik jest niepoprawny.

Porównanie null z dowolnym typem referencyjnym jest dozwolone i nie generuje wyjątku podczas korzystania z interfejsu IComparable<T> ogólnego. Podczas sortowania uważa się, null że jest on mniejszy niż jakikolwiek inny obiekt.

Jeśli element List<T> zawiera więcej niż jeden element o tej samej wartości, metoda zwraca tylko jedno z wystąpień i może zwrócić dowolne z wystąpień, niekoniecznie pierwsze.

Jeśli parametr List<T> nie zawiera określonej wartości, metoda zwraca ujemną liczbę całkowitą. Możesz zastosować operację uzupełniania bitowego (~) do tej ujemnej liczby całkowitej, aby uzyskać indeks pierwszego elementu, który jest większy niż wartość wyszukiwania. Podczas wstawiania wartości do List<T>klasy należy użyć tego indeksu jako punktu wstawiania, aby zachować kolejność sortowania.

Ta metoda jest operacją O(log n), gdzie n jest liczbą elementów w zakresie.

Zobacz też

Dotyczy