ImmutableList<T>.Builder.BinarySearch メソッド

定義

オーバーロード

BinarySearch(T)

既定の比較子を使用して、ImmutableList<T>.Builder 全体で要素を検索し、その要素の 0 から始まるインデックスを返します。Searches the entire ImmutableList<T>.Builder for an element using the default comparer and returns the zero-based index of the element.

BinarySearch(T, IComparer<T>)

指定した比較子を使用して、ImmutableList<T>.Builder 全体で要素を検索し、その要素の 0 から始まるインデックスを返します。Searches the entire ImmutableList<T>.Builder for an element using the specified comparer and returns the zero-based index of the element.

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

指定した比較子を使用して、ImmutableList<T>.Builder の指定された範囲内で要素を検索し、その要素の 0 から始まるインデックスを返します。Searches the specified range of the ImmutableList<T>.Builder for an element using the specified comparer and returns the zero-based index of the element.

BinarySearch(T)

既定の比較子を使用して、ImmutableList<T>.Builder 全体で要素を検索し、その要素の 0 から始まるインデックスを返します。Searches the entire ImmutableList<T>.Builder for an element using the default comparer and returns the zero-based index of the element.

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

パラメーター

item
T

検索するオブジェクト。The object to locate. 値は、参照型に対しては null にすることができます。The value can be null for reference types.

戻り値

項目が見つかった場合は、ImmutableList<T>.Builder 内の項目の 0 から始まるインデックス。見つからなかった場合は、負の値。これは、item の次に大きい要素のインデックスのビットごとの補数です。The zero-based index of item in the ImmutableList<T>.Builder, 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.

例外

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

注釈

ImmutableList<T>.Builder に指定された値が含まれていない場合、メソッドは負の整数を返します。If the ImmutableList<T>.Builder 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. ImmutableList<T>.Builderに値を挿入する場合、並べ替え順序を維持するために、このインデックスを挿入ポイントとして使用する必要があります。When inserting the value into the ImmutableList<T>.Builder, this index should be used as the insertion point to maintain the sort order.

BinarySearch(T, IComparer<T>)

指定した比較子を使用して、ImmutableList<T>.Builder 全体で要素を検索し、その要素の 0 から始まるインデックスを返します。Searches the entire ImmutableList<T>.Builder for an element using the specified comparer and returns the zero-based index of the element.

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

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

comparer
IComparer<T>

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

戻り値

項目が見つかった場合は、ImmutableList<T>.Builder 内の項目の 0 から始まるインデックス。見つからなかった場合は、負の値。これは、item の次に大きい要素のインデックスのビットごとの補数です。The zero-based index of item in the ImmutableList<T>.Builder, 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.

例外

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

注釈

ImmutableList<T>.Builder に指定された値が含まれていない場合、メソッドは負の整数を返します。If the ImmutableList<T>.Builder 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. ImmutableList<T>.Builderに値を挿入する場合、並べ替え順序を維持するために、このインデックスを挿入ポイントとして使用する必要があります。When inserting the value into the ImmutableList<T>.Builder, this index should be used as the insertion point to maintain the sort order.

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

指定した比較子を使用して、ImmutableList<T>.Builder の指定された範囲内で要素を検索し、その要素の 0 から始まるインデックスを返します。Searches the specified range of the ImmutableList<T>.Builder for an element using the specified comparer and returns the zero-based index of the element.

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

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

count
Int32

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

item
T

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

comparer
IComparer<T>

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

戻り値

項目が見つかった場合は、ImmutableList<T>.Builder 内の項目の 0 から始まるインデックス。見つからなかった場合は、負の値。これは、item の次に大きい要素のインデックスのビットごとの補数です。The zero-based index of item in the ImmutableList<T>.Builder, 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.

例外

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

注釈

ImmutableList<T>.Builder に指定された値が含まれていない場合、メソッドは負の整数を返します。If the ImmutableList<T>.Builder 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. ImmutableList<T>.Builderに値を挿入する場合、並べ替え順序を維持するために、このインデックスを挿入ポイントとして使用する必要があります。When inserting the value into the ImmutableList<T>.Builder, this index should be used as the insertion point to maintain the sort order.

適用対象