List<T>.BinarySearch Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Collections.Generic
Bütünleştirilmiş Kod:
System.Collections.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Sıralanmış List<T> veya bir bölümündeki belirli bir öğeyi bulmak için ikili arama algoritması kullanır.

Aşırı Yüklemeler

BinarySearch(T)

Varsayılan karşılaştırıcıyı kullanarak tüm sıralanmış List<T> öğeyi arar ve öğenin sıfır tabanlı dizinini döndürür.
BinarySearch(T, IComparer<T>)

Belirtilen karşılaştırıcıyı kullanarak bir öğe için sıralanmış List<T> olan tüm öğeyi arar ve öğenin sıfır tabanlı dizinini döndürür.
BinarySearch(Int32, Int32, T, IComparer<T>)

Belirtilen karşılaştırıcıyı kullanarak bir öğe için sıralanmış List<T> içindeki bir öğe aralığını arar ve öğenin sıfır tabanlı dizinini döndürür.

BinarySearch(T)

Kaynak:
List.cs
Kaynak:
List.cs
Kaynak:
List.cs

Varsayılan karşılaştırıcıyı kullanarak tüm sıralanmış List<T> öğeyi arar ve öğenin sıfır tabanlı dizinini döndürür.

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

Parametreler

item
T

Bulunacak nesne. Değer başvuru türleri için olabilir null .

Döndürülenler

Int32

bulunursa, sıralanmış List<T>içinde sıfır tabanlı diziniitem; aksi takdirdeitem, veya daha büyük item bir öğe yoksa bit düzeyinde tamamlayıcı olan bir sonraki öğenin dizininin Countbit düzeyinde tamamlayıcısı olan negatif bir sayıdır.

Özel durumlar

InvalidOperationException

Varsayılan karşılaştırıcıDefault, türü için Tgenel arabirimin IComparable<T> veya arabiriminin IComparable uygulamasını bulamıyor.

Örnekler

Aşağıdaki örnekte yöntem aşırı yüklemesi ve yöntem aşırı yüklemesi gösterilmektedir Sort()BinarySearch(T) . Dizelerden List<T> biri oluşturulur ve belirli bir sırada dört dizeyle doldurulur. Liste görüntülenir, sıralanır ve yeniden görüntülenir.

Yöntem BinarySearch(T) aşırı yüklemesi daha sonra listede olmayan iki dizeyi aramak için kullanılır ve Insert bunları eklemek için yöntemi kullanılır. Dizeler listede olmadığından yöntemin dönüş değeri BinarySearch(T) her durumda negatiftir. Bu negatif sayının bit düzeyinde tamamlayıcısı (C# ve Visual C++'da ~ işleci, Xor Visual Basic'te -1) alınması, listedeki arama dizesinden daha büyük olan ilk öğenin dizinini oluşturur ve bu konuma ekleme işlemi sıralama düzenini korur. İkinci arama dizesi listedeki herhangi bir öğeden daha büyük olduğundan ekleme konumu listenin sonundadır.

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

Açıklamalar

Bu yöntem, liste öğelerinin sırasını belirlemek için tür T için varsayılan karşılaştırıcıyı Comparer<T>.Default kullanır. özelliği, Comparer<T>.Default türün TIComparable<T> genel arabirimi uygulayıp uygulamadığını denetler ve varsa bu uygulamayı kullanır. Aksi takdirde, Comparer<T>.Default türün TIComparable arabirimi uygulayıp uygulamadığını denetler. Tür T iki arabirimi de uygulamazsa, Comparer<T>.Default bir InvalidOperationExceptionoluşturur.

zaten List<T> karşılaştırıcı uygulamasına göre sıralanmalıdır; aksi takdirde sonuç yanlıştır.

Herhangi bir başvuru türüyle karşılaştırmaya null izin verilir ve genel arabirim kullanılırken IComparable<T> özel durum oluşturmaz. Sıralama sırasında, null diğer nesnelerden daha az olarak kabul edilir.

aynı değere List<T> sahip birden fazla öğe içeriyorsa, yöntemi oluşumlardan yalnızca birini döndürür ve oluşumlardan herhangi birini döndürebilir; ilk öğeyi döndürmeyebilir.

List<T> belirtilen değeri içermiyorsa, yöntem negatif bir tamsayı döndürür. Arama değerinden daha büyük olan ilk öğenin dizinini almak için bit düzeyinde tamamlama işlemini (~) bu negatif tamsayıya uygulayabilirsiniz. değerine değer List<T>eklenirken, sıralama düzenini korumak için ekleme noktası olarak bu dizin kullanılmalıdır.

Bu yöntem bir O(günlük n) işlemidir; burada n aralıktaki öğelerin sayısıdır.

Ayrıca bkz.

Şunlara uygulanır

BinarySearch(T, IComparer<T>)

Kaynak:
List.cs
Kaynak:
List.cs
Kaynak:
List.cs

Belirtilen karşılaştırıcıyı kullanarak bir öğe için sıralanmış List<T> olan tüm öğeyi arar ve öğenin sıfır tabanlı dizinini döndürür.

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

Parametreler

item
T

Bulunacak nesne. Değer başvuru türleri için olabilir null .

comparer
IComparer<T>

IComparer<T> Öğeleri karşılaştırırken kullanılacak uygulama.

-veya-

null varsayılan karşılaştırıcıyı Defaultkullanmak için .

Döndürülenler

Int32

bulunursa, sıralanmış List<T>içinde sıfır tabanlı diziniitem; aksi takdirdeitem, veya daha büyük item bir öğe yoksa bit düzeyinde tamamlayıcı olan bir sonraki öğenin dizininin Countbit düzeyinde tamamlayıcısı olan negatif bir sayıdır.

Özel durumlar

InvalidOperationException

comparerşeklindedir nullve varsayılan karşılaştırıcıDefault, türü Tiçin genel arabirimin IComparable<T> veya arabiriminin IComparable uygulamasını bulamaz.

Örnekler

Aşağıdaki örnekte yöntem aşırı yüklemesi ve yöntem aşırı yüklemesi gösterilmektedir Sort(IComparer<T>)BinarySearch(T, IComparer<T>) .

Örnek, (IComparer(Of String) Visual Basic'teIComparer<String^>, Visual C++'da) genel arabirimini IComparer<string> uygulayan DinoCompare adlı dizeler için alternatif bir karşılaştırıcı tanımlar. Karşılaştırıcı aşağıdaki gibi çalışır: İlk olarak, karşılaştırıcılar için nulltest edilir ve null başvuru null olmayan bir başvurudan küçük olarak kabul edilir. İkincisi, dize uzunlukları karşılaştırılır ve uzun dize daha büyük olarak kabul edilir. Üçüncüsü, uzunluklar eşitse, normal dize karşılaştırması kullanılır.

Dizelerden List<T> biri oluşturulur ve belirli bir sırada dört dizeyle doldurulur. Liste görüntülenir, alternatif karşılaştırıcı kullanılarak sıralanır ve yeniden görüntülenir.

Daha BinarySearch(T, IComparer<T>) sonra yöntem aşırı yüklemesi, alternatif karşılaştırıcıyı kullanarak listede bulunmayan birkaç dizeyi aramak için kullanılır. Insert yöntemi, dizeleri eklemek için kullanılır. Bu iki yöntem, tarafından döndürülen BinarySearch(T, IComparer<T>) negatif sayının bit düzeyinde tamamlayıcısını (C# ve Visual C++'da ~ işleci, Xor -1) alan kodla birlikte adlı SearchAndInsertişlevde bulunur ve bunu yeni dizeyi eklemek için dizin olarak kullanır.

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

Açıklamalar

Karşılaştırıcı, öğelerin nasıl karşılaştırılacağını özelleştirir. Örneğin, büyük/küçük harfe duyarsız dize aramaları gerçekleştirmek için bir örneği karşılaştırıcı olarak kullanabilirsiniz CaseInsensitiveComparer .

sağlanırsa comparer , öğeleri List<T> belirtilen uygulama kullanılarak belirtilen değerle IComparer<T> karşılaştırılır.

ise comparernull, varsayılan karşılaştırıcı Comparer<T>.Default türün TIComparable<T> genel arabirimi uygulayıp uygulamadığını denetler ve varsa bu uygulamayı kullanır. Aksi takdirde, Comparer<T>.Default türün TIComparable arabirimi uygulayıp uygulamadığını denetler. Tür T iki arabirimi de uygulamazsa, Comparer<T>.Default oluşturur InvalidOperationException.

zaten List<T> karşılaştırıcı uygulamasına göre sıralanmalıdır; aksi takdirde sonuç yanlıştır.

Herhangi bir başvuru türüyle karşılaştırmaya null izin verilir ve genel arabirim kullanılırken IComparable<T> özel durum oluşturmaz. Sıralama sırasında, null diğer nesnelerden daha az olarak kabul edilir.

aynı değere List<T> sahip birden fazla öğe içeriyorsa, yöntemi oluşumlardan yalnızca birini döndürür ve oluşumlardan herhangi birini döndürebilir; ilk öğeyi döndürmeyebilir.

List<T> belirtilen değeri içermiyorsa, yöntem negatif bir tamsayı döndürür. Arama değerinden daha büyük olan ilk öğenin dizinini almak için bit düzeyinde tamamlama işlemini (~) bu negatif tamsayıya uygulayabilirsiniz. değerine değer List<T>eklenirken, sıralama düzenini korumak için ekleme noktası olarak bu dizin kullanılmalıdır.

Bu yöntem bir O(günlük n) işlemidir; burada n aralıktaki öğelerin sayısıdır.

Ayrıca bkz.

Şunlara uygulanır

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

Kaynak:
List.cs
Kaynak:
List.cs
Kaynak:
List.cs

Belirtilen karşılaştırıcıyı kullanarak bir öğe için sıralanmış List<T> öğe aralığını arar ve öğenin sıfır tabanlı dizinini döndürür.

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

Parametreler

index
Int32

Aranacak aralığın sıfır tabanlı başlangıç dizini.

count
Int32

Aranacak aralık uzunluğu.

item
T

Bulunacak nesne. Değer başvuru türleri için olabilir null .

comparer
IComparer<T>

IComparer<T> Öğeleri karşılaştırırken veya null varsayılan karşılaştırıcıyı Defaultkullanırken kullanılacak uygulama.

Döndürülenler

Int32

sıralanmış List<T>içinde sıfır tabanlı dizini item bulunursaitem; aksi takdirde, veya değerinden büyük item bir sonraki öğenin dizininin bit düzeyinde tamamlayıcısı olan negatif bir sayı, daha büyük bir öğe yoksa bit düzeyinde tamamlayıcısı Countolur.

Özel durumlar

ArgumentOutOfRangeException

index 0'dan küçüktür.

-veya-

count 0'dan küçüktür.

ArgumentException

index ve count içindeki List<T>geçerli bir aralığı ifade etmeyin.

InvalidOperationException

comparerşeklindedir nullve varsayılan karşılaştırıcıDefault, türü Tiçin genel arabirimin IComparable<T> veya arabiriminin IComparable uygulamasını bulamaz.

Örnekler

Aşağıdaki örnekte yöntem aşırı yüklemesi ve yöntem aşırı yüklemesi gösterilmektedir Sort(Int32, Int32, IComparer<T>)BinarySearch(Int32, Int32, T, IComparer<T>) .

Örnek, (IComparer(Of String) Visual Basic'teIComparer<String^>, Visual C++'da) genel arabirimini IComparer<string> uygulayan DinoCompare adlı dizeler için alternatif bir karşılaştırıcı tanımlar. Karşılaştırıcı aşağıdaki gibi çalışır: İlk olarak, karşılaştırıcılar için nulltest edilir ve null başvuru null olmayan bir başvurudan küçük olarak kabul edilir. İkincisi, dize uzunlukları karşılaştırılır ve uzun dize daha büyük olarak kabul edilir. Üçüncüsü, uzunluklar eşitse, normal dize karşılaştırması kullanılır.

Bir List<T> dizeler oluşturulur ve beş otçul dinozor ve üç etçil dinozorların isimleri ile doldurulur. İki grubun her birinde, adlar belirli bir sıralama düzeninde değildir. Liste görüntülenir, herbivor aralığı alternatif karşılaştırıcı kullanılarak sıralanır ve liste yeniden görüntülenir.

Yöntem BinarySearch(Int32, Int32, T, IComparer<T>) aşırı yüklemesi daha sonra yalnızca "Brachiosaurus" için herbivor aralığını aramak için kullanılır. Dize bulunamadı ve yöntem tarafından BinarySearch(Int32, Int32, T, IComparer<T>) döndürülen negatif sayının bit düzeyinde tamamlayıcısı (C# ve Visual C++'da ~ işleci, Xor Visual Basic'te -1), yeni dizeyi eklemek için dizin olarak kullanılır.

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

Açıklamalar

Karşılaştırıcı, öğelerin nasıl karşılaştırılacağını özelleştirir. Örneğin, büyük/küçük harfe duyarsız dize aramaları gerçekleştirmek için bir örneği karşılaştırıcı olarak kullanabilirsiniz CaseInsensitiveComparer .

sağlanırsa comparer , öğeleri List<T> belirtilen uygulama kullanılarak belirtilen değerle IComparer<T> karşılaştırılır.

ise comparernull, varsayılan karşılaştırıcı Comparer<T>.Default türün TIComparable<T> genel arabirimi uygulayıp uygulamadığını denetler ve varsa bu uygulamayı kullanır. Aksi takdirde, Comparer<T>.Default türün TIComparable arabirimi uygulayıp uygulamadığını denetler. Tür T iki arabirimi de uygulamazsa, Comparer<T>.Default oluşturur InvalidOperationException.

zaten List<T> karşılaştırıcı uygulamasına göre sıralanmalıdır; aksi takdirde sonuç yanlıştır.

Herhangi bir başvuru türüyle karşılaştırmaya null izin verilir ve genel arabirim kullanılırken IComparable<T> özel durum oluşturmaz. Sıralama sırasında, null diğer nesnelerden daha az olarak kabul edilir.

aynı değere List<T> sahip birden fazla öğe içeriyorsa, yöntemi oluşumlardan yalnızca birini döndürür ve oluşumlardan herhangi birini döndürebilir; ilk öğeyi döndürmeyebilir.

List<T> belirtilen değeri içermiyorsa, yöntem negatif bir tamsayı döndürür. Arama değerinden daha büyük olan ilk öğenin dizinini almak için bit düzeyinde tamamlama işlemini (~) bu negatif tamsayıya uygulayabilirsiniz. değerine değer List<T>eklenirken, sıralama düzenini korumak için ekleme noktası olarak bu dizin kullanılmalıdır.

Bu yöntem bir O(log n) işlemidir; burada n aralıktaki öğelerin sayısıdır.

Ayrıca bkz.

Şunlara uygulanır