_lsearch_s

아티클
02/21/2013

값에 대 한 선형 검색을 수행합니다.버전 _lsearch 와 보안 기능 향상에 설명 된 대로 CRT의 보안 기능.

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
비교 루틴에 대 한 포인터입니다.두 번째 매개 변수는 검색에 대 한 키에 대 한 포인터입니다.세 번째 매개 변수는 키와 비교 하 여 배열 요소에 대 한 포인터입니다.
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	는	모든	EINVAL

설명

_lsearch_s 함수 값에 대 한 선형 검색을 수행 key 배열에 있는 num 의 각 요소를 width 바이트입니다.달리 bsearch_s, _lsearch_s 배열을 정렬 하려면 필요 하지 않습니다.경우 key 을 찾지 못한 되지 않습니다 _lsearch_s 배열 및 간격의 끝에 추가 num.

compare 함수 배열 요소 두 개를 비교 하 고 서로의 관계를 지정 하는 값을 반환 하는 사용자 제공 루틴에 대 한 포인터입니다.compare 함수는 또한 포인터를 첫 번째 인수를 컨텍스트로 사용 합니다._lsearch_s호출 compare 각 호출에서 두 배열 요소에 포인터를 전달 하는 검색 하는 동안 여러 번.compare요소를 비교 하 고 다음 중 하나를 반환 합니다 0이 아닌 (요소가 다른 수 없음) 또는 0 (요소를 동일한 수 없음).

context 포인터가 검색된 데이터 구조가 개체에 포함 된 경우 유용 하 게 사용할 수 있습니다 하는 compare 함수를 필요로 하는 개체의 멤버에 액세스할 수 있습니다.예를 들어, 코드는 compare 함수는 void 포인터 적절 한 개체 유형 및 액세스의 멤버 개체에 캐스팅 수 있습니다.추가 context 포인터가 있습니다 _lsearch_s 추가 컨텍스트 데이터를 사용할 수 있도록 정적 변수를 사용 하는 재진입 버그를 방지 하기 위해 사용 될 수 있으므로 더욱 안전한는 compare 함수입니다.