ImmutableList<T>.Builder.BinarySearch 方法

定義

命名空間:

System.Collections.Immutable

組件:

System.Collections.Immutable.dll

套件:

System.Collections.Immutable v9.0.0-rc.2.24473.5

多載

BinarySearch(T)	使用預設比較子搜尋專案的整個 ImmutableList<T>.Builder，並傳回專案以零起始的索引。
BinarySearch(T, IComparer<T>)	使用指定的比較子搜尋專案的整個 ImmutableList<T>.Builder，並傳回專案以零起始的索引。
BinarySearch(Int32, Int32, T, IComparer<T>)	使用指定的比較子搜尋專案的指定 ImmutableList<T>.Builder 範圍，並傳回專案以零起始的索引。

BinarySearch(T)

來源:

ImmutableList_1.Builder.cs

使用預設比較子搜尋專案的整個 ImmutableList<T>.Builder，並傳回專案以零起始的索引。

public:
 virtual int BinarySearch(T item);

public int BinarySearch (T item);

abstract member BinarySearch : 'T -> int
override this.BinarySearch : 'T -> int

Public Function BinarySearch (item As T) As Integer

參數

item

T

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

傳回

Int32

如果找到專案，則為 ImmutableList<T>.Builder中以零起始的專案索引;否則，負數，這個數位是下一個大於 item之元素之索引的位補碼。

例外狀況

InvalidOperationException

默認比較子 Default 找不到類型 T IComparable<T> 泛型介面或 IComparable 介面的實作。

備註

如果 ImmutableList<T>.Builder 不包含指定的值，此方法會傳回負整數。 您可以將位補碼運算 （~） 套用至這個負整數，以取得大於搜尋值之第一個專案的索引。 將值插入 ImmutableList<T>.Builder時，這個索引應該當做插入點來維護排序順序。

BinarySearch(T, IComparer<T>)

來源:

ImmutableList_1.Builder.cs

使用指定的比較子搜尋專案的整個 ImmutableList<T>.Builder，並傳回專案以零起始的索引。

public:
 virtual int BinarySearch(T item, System::Collections::Generic::IComparer<T> ^ comparer);

public int BinarySearch (T item, System.Collections.Generic.IComparer<T>? comparer);

abstract member BinarySearch : 'T * System.Collections.Generic.IComparer<'T> -> int
override 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

如果找到專案，則為 ImmutableList<T>.Builder中以零起始的專案索引;否則，負數，這個數位是下一個大於 item之元素之索引的位補碼。

例外狀況

InvalidOperationException

comparer 是 null，而預設比較子 Default 找不到類型 T 的 IComparable<T> 泛型介面或 IComparable 介面的實作。

備註

如果 ImmutableList<T>.Builder 不包含指定的值，此方法會傳回負整數。 您可以將位補碼運算 （~） 套用至這個負整數，以取得大於搜尋值之第一個專案的索引。 將值插入 ImmutableList<T>.Builder時，這個索引應該當做插入點來維護排序順序。

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

來源:

ImmutableList_1.Builder.cs

使用指定的比較子搜尋專案的指定 ImmutableList<T>.Builder 範圍，並傳回專案以零起始的索引。

public:
 virtual 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);

abstract member BinarySearch : int * int * 'T * System.Collections.Generic.IComparer<'T> -> int
override 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

如果找到專案，則為 ImmutableList<T>.Builder中以零起始的專案索引;否則，負數，這個數位是下一個大於 item之元素之索引的位補碼。

例外狀況

ArgumentOutOfRangeException

index 小於0。 -或-

count 小於0。

ArgumentException

index 和 count 不表示 List<T>中的有效範圍。

InvalidOperationException

comparer 是 null，而預設比較子 Default 找不到類型 T 的 IComparable<T> 泛型介面或 IComparable 介面的實作。

備註

如果 ImmutableList<T>.Builder 不包含指定的值，此方法會傳回負整數。 您可以將位補碼運算 （~） 套用至這個負整數，以取得大於搜尋值之第一個專案的索引。 將值插入 ImmutableList<T>.Builder時，這個索引應該當做插入點來維護排序順序。