_lfind
指定したキーのリニア サーチを実行します。この関数のセキュリティが強化されたバージョンについては、「_lfind_s」を参照してください。
void *_lfind(
const void *key,
const void *base,
unsigned int *num,
unsigned int width,
int (__cdecl *compare)(const void *, const void *)
);
パラメーター
key
検索するオブジェクト。base
検索するデータ配列のベースへのポインター。num
配列要素の数。width
配列要素の幅。compare
比較ルーチンへのポインター。最初のパラメーターは検索用に調整するポインターです。2 番目のパラメーターはキーと比較される配列要素へのポインターです。
戻り値
キーが存在する場合_lfind はbase で配列の要素に一致 key ポインターを返します。キーが存在しない場合_lfind は NULL を返します。
解説
_lfind の関数は num の要素の配列と width の各バイトの値 key のリニア サーチを実行します。bsearch とは異なり_lfind は配列を並べ替える必要がありません。base の引数は検索する配列のベースへのポインターです。compare の引数には2 種類の配列の要素を比較し指定する値を返すユーザー関係を指定するルーチンへのポインターです。_lfind は一つ以上の時間各呼び出しの 2 種類の配列要素へのポインターを渡す検索中に compare ルーチンを呼び出します。compare ルーチンは要素を比較しゼロ以外 (要素を意味して異なる場合) 0 を返す必要があります (要素は同じ意味になります)。
この関数は、パラメーターを検証します。comparekey または num が NULL であるかまたはが null base 場合*num がゼロ以外が width 未満の場合無効なパラメーター ハンドラーが パラメーターの検証 に説明されているように開始されます。実行の継続が許可された場合、errno が EINVAL に設定され、関数から NULL が返されます。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_lfind |
<search.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_lfind.c
// This program uses _lfind to search a string array
// for an occurrence of "hello".
#include <search.h>
#include <string.h>
#include <stdio.h>
int compare(const void *arg1, const void *arg2 )
{
return( _stricmp( * (char**)arg1, * (char**)arg2 ) );
}
int main( )
{
char *arr[] = {"Hi", "Hello", "Bye"};
int n = sizeof(arr) / sizeof(char*);
char **result;
char *key = "hello";
result = (char **)_lfind( &key, arr,
&n, sizeof(char *), compare );
if( result )
printf( "%s found\n", *result );
else
printf( "hello not found!\n" );
}
同等の .NET Framework 関数
System:: コレクション :: ArrayList:: 含まれます。