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

定義

バイナリ サーチ アルゴリズムを使用して、並べ替えられた List<T> 内の特定の要素またはその一部を検索します。Uses a binary search algorithm to locate a specific element in the sorted List<T> or a portion of it.

オーバーロード

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

既定の比較子を使用して、並べ替えられた要素の List<T> 全体を検索し、その要素の 0 から始まるインデックスを返します。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>)

指定した比較子を使用して、並べ替えられた要素の List<T> 全体を検索し、その要素の 0 から始まるインデックスを返します。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>)

指定した比較子を使用して、並べ替えられた要素の List<T> の 1 つの要素の範囲を検索し、その要素の 0 から始まるインデックスを返します。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)

既定の比較子を使用して、並べ替えられた要素の List<T> 全体を検索し、その要素の 0 から始まるインデックスを返します。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

パラメーター

item
T T T T

検索するオブジェクト。The object to locate. 参照型の場合は null の値を使用できます。The value can be null for reference types.

戻り値

item が見つかった場合は、並べ替えられた List<T> 内の item の 0 から始まるインデックス。見つからなかった場合は、負の値。これは、item の次に大きい要素のインデックスのビットごとの補数です。ただし、大きい要素が存在しない場合は、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.

例外

既定の比較子 Default は、IComparable<T> ジェネリック インターフェイスの実装、または型 TIComparable インターフェイスの実装を見つけることができません。The default comparer Default cannot find an implementation of the IComparable<T> generic interface or the IComparable interface for type T.

次の例で、Sort()メソッドのオーバー ロードとBinarySearch(T)メソッドのオーバー ロードします。The following example demonstrates the Sort() method overload and the BinarySearch(T) method overload. AList<T>文字列の任意の順序で、4 つの文字列を設定して作成されます。A List<T> of strings is created and populated with four strings, in no particular order. 一覧が表示され、並べ替え、もう一度表示されます。The list is displayed, sorted, and displayed again.

BinarySearch(T)メソッドのオーバー ロードは、一覧にない 2 つの文字列を検索するために使用し、Insertに挿入するメソッドを使用します。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. 戻り値、BinarySearch(T)メソッドは、文字列は、一覧にないため、各ケースで負の値。The return value of the BinarySearch(T) method is negative in each case, because the strings are not in the list. ビットごとの補数を取得 (、~ 演算子が C# および Visual C、 Xor -1 Visual Basic で) この負の数値の生成は、この場所にして、検索文字列より大きい一覧の最初の要素のインデックスには、並べ替えが保持されます順序。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. 2 番目の検索文字列は、カーソルの位置がリストの末尾に、一覧で、任意の要素を超えています。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

注釈

このメソッドは、既定の比較子を使用してComparer<T>.DefaultTリストの要素の順序を決定します。This method uses the default comparer Comparer<T>.Default for type T to determine the order of list elements. Comparer<T>.Defaultプロパティ確認を入力するかどうかT実装、IComparable<T>ジェネリック インターフェイスと、使用可能な場合は、その実装を使用します。The Comparer<T>.Default property checks whether type T implements the IComparable<T> generic interface and uses that implementation, if available. ない場合は、Comparer<T>.Defaultチェックを入力するかどうかT実装、IComparableインターフェイス。If not, Comparer<T>.Default checks whether type T implements the IComparable interface. 場合型Tいずれかのインターフェイスを実装していませんComparer<T>.Defaultスロー、InvalidOperationExceptionします。If type T does not implement either interface, Comparer<T>.Default throws an InvalidOperationException.

List<T>既に装; に従って並べ替える必要がありますそれ以外の場合、結果が正しくありません。The List<T> must already be sorted according to the comparer implementation; otherwise, the result is incorrect.

比較するnull型のすべての参照では許可されを使用する場合は、例外を生成しません、IComparable<T>ジェネリック インターフェイス。Comparing null with any reference type is allowed and does not generate an exception when using the IComparable<T> generic interface. ときに、並べ替え、null未満、他のオブジェクトと見なされます。When sorting, null is considered to be less than any other object.

場合、List<T>だけを含む同じの値を持つ 1 つ以上の要素を返します、出現してのいずれかの出現回数、必ずしも 1 つ目のいずれかを返す可能性があります。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.

場合、List<T>に指定した値が含まれていないメソッドは負の整数を返します。If the List<T> does not contain the specified value, the method returns a negative integer. この負の整数値を検索する値を超える最初の要素のインデックスを取得するには、ビットごとの補数演算 (~) を適用できます。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. 値を挿入するときに、 List<T>、このインデックスは、並べ替え順序を維持するために、挿入ポイントとして使用する必要があります。When inserting the value into the List<T>, this index should be used as the insertion point to maintain the sort order.

このメソッドは O (log n) 操作、場所n範囲内の要素の数です。This method is an O(log n) operation, where n is the number of elements in the range.

こちらもご覧ください

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

指定した比較子を使用して、並べ替えられた要素の List<T> 全体を検索し、その要素の 0 から始まるインデックスを返します。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

パラメーター

item
T T T T

検索するオブジェクト。The object to locate. 参照型の場合は null の値を使用できます。The value can be null for reference types.

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

要素を比較する場合に使用する IComparer<T> の実装。The IComparer<T> implementation to use when comparing elements.

または-or- 既定の比較子 Default を使用する場合は nullnull to use the default comparer Default.

戻り値

item が見つかった場合は、並べ替えられた List<T> 内の item の 0 から始まるインデックス。見つからなかった場合は、負の値。これは、item の次に大きい要素のインデックスのビットごとの補数です。ただし、大きい要素が存在しない場合は、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.

例外

comparernull です。また、既定の比較子 Default は、IComparable<T> ジェネリック インターフェイスの実装、または型 TIComparable インターフェイスの実装を見つけることができません。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.

次の例で、Sort(IComparer<T>)メソッドのオーバー ロードとBinarySearch(T, IComparer<T>)メソッドのオーバー ロードします。The following example demonstrates the Sort(IComparer<T>) method overload and the BinarySearch(T, IComparer<T>) method overload.

例では、定義を実装する、DinoCompare という名前の文字列の代替の比較子、 IComparer<string> (IComparer(Of String) Visual Basic でIComparer<String^>Visual C で) ジェネリック インターフェイス。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. 比較演算子はように動作します。最初にの比較対照値がテストされますnull、null 参照が null でない未満として扱われます。The comparer works as follows: First, the comparands are tested for null, and a null reference is treated as less than a non-null. 次に、文字列の長さを比較してより長い文字列が大きいと見なされます。Second, the string lengths are compared, and the longer string is deemed to be greater. 3 番目に、長さが等しい場合は、通常の文字列比較が使用されます。Third, if the lengths are equal, ordinary string comparison is used.

AList<T>文字列の任意の順序で、4 つの文字列を設定して作成されます。A List<T> of strings is created and populated with four strings, in no particular order. 一覧が表示されます、代替の比較子を使用して並べ替えられ、表示されているもう一度。The list is displayed, sorted using the alternate comparer, and displayed again.

BinarySearch(T, IComparer<T>)メソッドのオーバー ロードが複数の文字列の一覧で採用していない別の比較子を検索に使用されるからです。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. Insert文字列を挿入するメソッドを使用します。The Insert method is used to insert the strings. という名前の関数でこれら 2 つのメソッドにあるSearchAndInsert、ビットごとの補数をコードと共に (、~ 演算子が C# および Visual C、 Xor Visual Basic で-1) によって返される負の数値のBinarySearch(T, IComparer<T>)のインデックスとして使用新しい文字列を挿入します。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

注釈

比較演算子は、要素の比較方法をカスタマイズします。The comparer customizes how the elements are compared. たとえば、使用することができます、CaseInsensitiveComparer大文字の文字列検索を実行する比較子としてインスタンス。For example, you can use a CaseInsensitiveComparer instance as the comparer to perform case-insensitive string searches.

場合comparerが提供されるの要素、List<T>指定して、指定した値と比較されますIComparer<T>実装します。If comparer is provided, the elements of the List<T> are compared to the specified value using the specified IComparer<T> implementation.

場合comparernull、既定の比較子Comparer<T>.Defaultチェックを入力するかどうかT実装、IComparable<T>ジェネリック インターフェイスと使用可能な場合は、その実装を使用します。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. ない場合は、Comparer<T>.Defaultチェックを入力するかどうかT実装、IComparableインターフェイス。If not, Comparer<T>.Default checks whether type T implements the IComparable interface. 場合型Tいずれかのインターフェイスを実装していませんComparer<T>.DefaultスローInvalidOperationExceptionします。If type T does not implement either interface, Comparer<T>.Default throws InvalidOperationException.

List<T>既に装; に従って並べ替える必要がありますそれ以外の場合、結果が正しくありません。The List<T> must already be sorted according to the comparer implementation; otherwise, the result is incorrect.

比較するnull型のすべての参照では許可されを使用する場合は、例外を生成しません、IComparable<T>ジェネリック インターフェイス。Comparing null with any reference type is allowed and does not generate an exception when using the IComparable<T> generic interface. ときに、並べ替え、null未満、他のオブジェクトと見なされます。When sorting, null is considered to be less than any other object.

場合、List<T>だけを含む同じの値を持つ 1 つ以上の要素を返します、出現してのいずれかの出現回数、必ずしも 1 つ目のいずれかを返す可能性があります。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.

場合、List<T>に指定した値が含まれていないメソッドは負の整数を返します。If the List<T> does not contain the specified value, the method returns a negative integer. この負の整数値を検索する値を超える最初の要素のインデックスを取得するには、ビットごとの補数演算 (~) を適用できます。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. 値を挿入するときに、 List<T>、このインデックスは、並べ替え順序を維持するために、挿入ポイントとして使用する必要があります。When inserting the value into the List<T>, this index should be used as the insertion point to maintain the sort order.

このメソッドは O (log n) 操作、場所n範囲内の要素の数です。This method is an O(log n) operation, where n is the number of elements in the range.

こちらもご覧ください

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

指定した比較子を使用して、並べ替えられた要素の List<T> の 1 つの要素の範囲を検索し、その要素の 0 から始まるインデックスを返します。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

パラメーター

index
Int32 Int32 Int32 Int32

検索範囲の開始位置を示す 0 から始まるインデックス。The zero-based starting index of the range to search.

count
Int32 Int32 Int32 Int32

検索する範囲の長さ。The length of the range to search.

item
T T T T

検索するオブジェクト。The object to locate. 参照型の場合は null の値を使用できます。The value can be null for reference types.

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

要素を比較する場合に使用する IComparer<T> 実装。または、既定の比較子 Default を使用する場合は nullThe IComparer<T> implementation to use when comparing elements, or null to use the default comparer Default.

戻り値

item が見つかった場合は、並べ替えられた List<T> 内の item の 0 から始まるインデックス。見つからなかった場合は、負の値。これは、item の次に大きい要素のインデックスのビットごとの補数です。ただし、大きい要素が存在しない場合は、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.

例外

index が 0 未満です。index is less than 0.

または-or- count が 0 未満です。count is less than 0.

index および countList<T> において有効な範囲を表していません。index and count do not denote a valid range in the List<T>.

comparernull です。また、既定の比較子 Default は、IComparable<T> ジェネリック インターフェイスの実装、または型 TIComparable インターフェイスの実装を見つけることができません。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.

次の例で、Sort(Int32, Int32, IComparer<T>)メソッドのオーバー ロードとBinarySearch(Int32, Int32, T, IComparer<T>)メソッドのオーバー ロードします。The following example demonstrates the Sort(Int32, Int32, IComparer<T>) method overload and the BinarySearch(Int32, Int32, T, IComparer<T>) method overload.

例では、定義を実装する、DinoCompare という名前の文字列の代替の比較子、 IComparer<string> (IComparer(Of String) Visual Basic でIComparer<String^>Visual C で) ジェネリック インターフェイス。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. 比較演算子はように動作します。最初にの比較対照値がテストされますnull、null 参照が null でない未満として扱われます。The comparer works as follows: First, the comparands are tested for null, and a null reference is treated as less than a non-null. 次に、文字列の長さを比較してより長い文字列が大きいと見なされます。Second, the string lengths are compared, and the longer string is deemed to be greater. 3 番目に、長さが等しい場合は、通常の文字列比較が使用されます。Third, if the lengths are equal, ordinary string comparison is used.

AList<T>文字列の 5 つの herbivorous 恐竜やから恐竜が 3 つの名前を設定して作成します。A List<T> of strings is created and populated with the names of five herbivorous dinosaurs and three carnivorous dinosaurs. 内で 2 つのグループごとに、名前は任意の特定の並べ替え順序でないですします。Within each of the two groups, the names are not in any particular sort order. 一覧が表示されます、恐竜の範囲は、代替の比較子を使用して並べ替えられて一覧が再び表示されます。The list is displayed, the range of herbivores is sorted using the alternate comparer, and the list is displayed again.

BinarySearch(Int32, Int32, T, IComparer<T>) "Brachiosaurus"恐竜の範囲のみを検索するメソッドのオーバー ロードが使用されるからです。The BinarySearch(Int32, Int32, T, IComparer<T>) method overload is then used to search only the range of herbivores for "Brachiosaurus". 文字列が見つからないとビットごとの補数 (、~ 演算子が C# および Visual C、 Xor Visual Basic で-1) によって返される負の数値のBinarySearch(Int32, Int32, T, IComparer<T>)メソッドが新しい文字列を挿入するためのインデックスとして使用します。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

注釈

比較演算子は、要素の比較方法をカスタマイズします。The comparer customizes how the elements are compared. たとえば、使用することができます、CaseInsensitiveComparer大文字の文字列検索を実行する比較子としてインスタンス。For example, you can use a CaseInsensitiveComparer instance as the comparer to perform case-insensitive string searches.

場合comparerが提供されるの要素、List<T>指定して、指定した値と比較されますIComparer<T>実装します。If comparer is provided, the elements of the List<T> are compared to the specified value using the specified IComparer<T> implementation.

場合comparernull、既定の比較子Comparer<T>.Defaultチェックを入力するかどうかT実装、IComparable<T>ジェネリック インターフェイスと使用可能な場合は、その実装を使用します。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. ない場合は、Comparer<T>.Defaultチェックを入力するかどうかT実装、IComparableインターフェイス。If not, Comparer<T>.Default checks whether type T implements the IComparable interface. 場合型Tいずれかのインターフェイスを実装していませんComparer<T>.DefaultスローInvalidOperationExceptionします。If type T does not implement either interface, Comparer<T>.Default throws InvalidOperationException.

List<T>既に装; に従って並べ替える必要がありますそれ以外の場合、結果が正しくありません。The List<T> must already be sorted according to the comparer implementation; otherwise, the result is incorrect.

比較するnull型のすべての参照では許可されを使用する場合は、例外を生成しません、IComparable<T>ジェネリック インターフェイス。Comparing null with any reference type is allowed and does not generate an exception when using the IComparable<T> generic interface. ときに、並べ替え、null未満、他のオブジェクトと見なされます。When sorting, null is considered to be less than any other object.

場合、List<T>だけを含む同じの値を持つ 1 つ以上の要素を返します、出現してのいずれかの出現回数、必ずしも 1 つ目のいずれかを返す可能性があります。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.

場合、List<T>に指定した値が含まれていないメソッドは負の整数を返します。If the List<T> does not contain the specified value, the method returns a negative integer. この負の整数値を検索する値を超える最初の要素のインデックスを取得するには、ビットごとの補数演算 (~) を適用できます。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. 値を挿入するときに、 List<T>、このインデックスは、並べ替え順序を維持するために、挿入ポイントとして使用する必要があります。When inserting the value into the List<T>, this index should be used as the insertion point to maintain the sort order.

このメソッドは O (log n) 操作、場所n範囲内の要素の数です。This method is an O(log n) operation, where n is the number of elements in the range.

こちらもご覧ください

適用対象