_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
検索する配列のベースへのポインター。num
要素の数。size
バイト配列の各要素のサイズ。compare
比較ルーチンへのポインター。2 番目のパラメーターは検索のキーへのポインターです。3 番目のパラメーターはキーと比較される配列要素へのポインターです。context
比較関数にアクセスする可能性のあるオブジェクトへのポインター。
戻り値
key がある場合は_lsearch_s はbase で配列の要素に一致 key ポインターを返します。key がない場合_lsearch_s が配列の末尾で新しく追加された項目へのポインターを返します。
この関数に無効なパラメーターが渡されると無効なパラメーター ハンドラーが パラメーターの検証 に説明されているように開始されます。実行の継続が許可 errno は EINVAL および関数の戻り値 NULL に設定されます。詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。
エラー条件
key |
base |
compare |
num |
size |
errno |
|---|---|---|---|---|---|
NULL |
任意 |
任意 |
任意 |
任意 |
EINVAL |
任意 |
NULL |
任意 |
!= 0 |
任意 |
EINVAL |
任意 |
任意 |
任意 |
任意 |
0 |
EINVAL |
任意 |
任意 |
NULL |
an |
任意 |
EINVAL |
解説
_lsearch_s の関数は num の要素の配列と width の各バイトの値 key のリニア サーチを実行します。bsearch_s とは異なり_lsearch_s は配列を並べ替える必要がありません。key がない場合_lsearch_s が配列の末尾に追加しnum をインクリメントします。
compare の関数は 2 種類の配列の要素を比較し指定する値を返すユーザー関係を指定するルーチンへのポインターです。compare の関数は最初の引数としてコンテキストへのポインターを渡します。_lsearch_s は一つ以上の時間各呼び出しの 2 種類の配列要素へのポインターを渡す検索中に compare を呼び出します。compare は要素を比較しゼロ以外 (要素を意味して異なる場合) 0 を返す必要があります (要素は同じ意味になります)。
context のポインターはオブジェクトのメンバーにアクセスする場合は検索対象のデータ構造体がオブジェクトと compare の関数のニーズに含まれる場合に便利です。たとえばcompare の関数のコードは適切なオブジェクトオブジェクト型に void ポインターにキャストしてそのオブジェクトのメンバーにアクセスできます。context の追加は静的変数の使用に関連するすべてのバグを避けるに compare の関数でデータを使用できるように追加のコンテキストを使用できるため _lsearch_s をより安全になります。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_lsearch_s |
<search.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。