ImmutableList<T>.BinarySearch 方法

定義

命名空間:

System.Collections.Immutable

組件:

System.Collections.Immutable.dll

多載

BinarySearch(T)	使用預設的比較子並傳回元素以零為起始的索引，來搜尋整個已排序的清單的某個元素。
BinarySearch(T, IComparer<T>)	使用指定的比較子並傳回元素以零為起始的索引，來搜尋整個已排序的清單中的某個元素。
BinarySearch(Int32, Int32, T, IComparer<T>)	使用指定的比較子在已排序之清單內搜尋某範圍的元素，並傳回該元素以零為起始的索引。

BinarySearch(T)

來源:

ImmutableList_1.cs

使用預設的比較子並傳回元素以零為起始的索引，來搜尋整個已排序的清單的某個元素。

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

要尋找的物件。 參考類型的值可以是 null。

傳回

Int32

如果有找到，則為已排序的清單中元素之以零為起始的索引，否則便為負數，此負數為大於元素的下一個元素索引之位元補數，或者，如果沒有更大的元素，則為 Count 的位元補數。

例外狀況

InvalidOperationException

預設比較子找不到類型 T 的比較子實作。

BinarySearch(T, IComparer<T>)

來源:

ImmutableList_1.cs

使用指定的比較子並傳回元素以零為起始的索引，來搜尋整個已排序的清單中的某個元素。

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

要尋找的物件。 參考類型的值可以是 Null。

comparer

IComparer<T>

比較專案或 null 時要使用的比較子實作，以使用預設比較子。

傳回

Int32

如果有找到，則為已排序的清單中元素之以零為起始的索引，否則便為負數，此負數為大於元素的下一個元素索引之位元補數，或者，如果沒有更大的元素，則為 Count 的位元補數。

例外狀況

InvalidOperationException

比較子是 null，而且預設比較子找不到類型 T 的比較子實作。

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

來源:

ImmutableList_1.cs

使用指定的比較子在已排序之清單內搜尋某範圍的元素，並傳回該元素以零為起始的索引。

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

要搜尋範圍內之以零為起始的起始索引。

count

Int32

搜尋範圍的長度。

item

T

要尋找的物件。 參考類型的值可以是 Null。

comparer

IComparer<T>

比較元素時要使用的比較子實作，或 null 表示使用預設比較子。

傳回

Int32

如果有找到，則為已排序的清單中元素之以零為起始的索引，否則便為負數，此負數為大於元素的下一個元素索引之位元補數，或者，如果沒有更大的元素，則為 count 的位元補數。

例外狀況

ArgumentOutOfRangeException

索引小於 0 或 count 小於 0。

ArgumentException

索引和 count 不代表清單中的有效範圍。

InvalidOperationException

comparer 是 null，而且預設比較子找不到類型 T 的比較子實作。