_lsearch_s

値の線形探索を実行します。 CRT の_lsearchセキュリティ機能の説明に従ってセキュリティが強化されたバージョン。

構文

void *_lsearch_s(
   const void *key,
   void *base,
   unsigned int *num,
   size_t size,
   int (__cdecl *compare)(void *, const void *, const void *),
   void * context
);

パラメーター

key
検索するオブジェクト。

base
検索する配列のベースへのポインター。

number
要素の数。

size
バイト単位での配列の各要素のサイズ。

compare
比較ルーチンへのポインター。 2 番目のパラメーターは、検索用のキーへのポインターです。 3 番目のパラメーターは、そのキーと比較する配列要素へのポインターです。

context
比較関数内でアクセスされることのあるオブジェクトへのポインター。

戻り値

key が見つかった場合、_lsearch_s は key と一致する base の配列要素のポインターを返します。 見つからない場合 key は、 _lsearch_s 配列の末尾に新しく追加された項目へのポインターを返します。

無効なパラメーターが関数に渡された場合、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行を続行できる場合、errno が EINVAL に設定され、関数から NULL が返されます。 詳細については、「errno」、「_doserrno」、「_sys_errlist」、および「_sys_nerr」を参照してください。

エラー条件

key	base	compare	number	size	errno
NULL	any	any	any	any	EINVAL
any	NULL	any	!= 0	any	EINVAL
any	any	any	any	ゼロ	EINVAL
any	any	NULL	1 つ	any	EINVAL

解説

_lsearch_s 関数は、number 要素の配列の値 key に対する一方向の検索を、size バイトごとに実行します。 とは異なり bsearch_s、 _lsearch_s 配列を並べ替える必要はありません。 見つからない場合 key は、 _lsearch_s 配列の末尾に追加してインクリメントします number。

compare 関数は、2 つの配列要素を比較してそれらの関係を指定する値を返すユーザー指定のルーチンへのポインターです。 compare 関数はまた、最初の引数としてコンテキストへのポインターを受け取ります。 _lsearch_s は検索中に compare を 1 回以上呼び出し、各呼び出しにおいて 2 つの配列要素へのポインターを渡します。 compare は要素を比較し、ゼロ以外 (要素が異なる場合) または 0 (要素が同じ場合) を返す必要があります。

context ポインターは、検索対象のデータ構造体がオブジェクトの一部であり、compare 関数でオブジェクトのメンバーにアクセスする必要がある場合に役立ちます。 たとえば、compare 関数のコードは void ポインターを該当するオブジェクト型にキャストして、そのオブジェクトのメンバーにアクセスできます。 ポインターを context 追加すると _lsearch_s 、追加のコンテキストを使用して、静的変数を使用して関数でデータを使用できるようにするために関連する再入バグを回避できるため、 compare より安全になります。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

ルーチンによって返される値	必須ヘッダー
_lsearch_s	<search.h>

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

検索と並べ替え
bsearch_s
_lfind_s
_lsearch