_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l_mbsnicoll_l

로캘별 정보를 사용하여 문자열을 비교합니다.

Important

Windows 런타임에서 실행되는 애플리케이션에서는 _mbsnicoll 및 _mbsnicoll_l을 사용할 수는 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.

구문

int _strnicoll(
   const char *string1,
   const char *string2,
   size_t count
);
int _wcsnicoll(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count
);
int _mbsnicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);
int _strnicoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicoll_l(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count,
   _locale_t locale
);
int _mbsnicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

매개 변수

string1, string2
비교할 Null 종료 문자열입니다.

count
비교할 문자 수입니다.

locale
사용할 로캘입니다.

반환 값

이러한 각 함수는 다음과 같이 부분 문자열 string1 의 string2관계를 나타내는 값을 반환합니다.

반환 값	문자열 1과 문자열 2의 관계
< 0	string1이 string2보다 짧음
0	string1 = string2
> 0	string1 > string2

이러한 각 함수는 _NLSCMPERROR를 반환합니다. _NLSCMPERROR를 사용하려면 STRING.H 또는 MBSTRING.H를 포함합니다. string1 또는 string2에 정렬 순서 도메인을 벗어나는 와이드 문자 코드가 포함된 경우 _wcsnicoll이 실패할 수 있습니다. 오류가 발생하면 _wcsnicoll에서 errno를 EINVAL로 설정할 수 있습니다. _wcsnicoll에 대한 호출 시 오류가 있는지 확인하려면 errno를 0으로 설정한 다음 _wcsnicoll 호출 후 errno를 검사합니다.

설명

이러한 각 함수는 코드 페이지에 따라 string1 및 string2에 있는 처음 count자를 대/소문자를 구분하지 않고 비교합니다. 이러한 함수는 코드 페이지에서 문자 집합 순서와 사전적 문자 순서 간에 차이가 있고 문자열 비교에 관심이 있는 경우에만 사용해야 합니다. _l 접미사가 없는 이러한 함수의 버전은 현재 로캘 및 코드 페이지를 사용합니다. 접미사가 있는 _l 버전은 전달된 로캘을 대신 사용한다는 점을 제외하고 동일합니다. 자세한 내용은 Locale을 참조하세요.

이러한 모든 함수는 해당 함수 매개 변수의 유효성을 검사합니다. Null 포인터이거나 string1 string2 null 포인터이거나 개수가 개수보다 INT_MAX크면 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용된 경우, 이러한 함수는 _NLSCMPERROR를 반환하고 errno를 EINVAL로 설정합니다.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

TCHAR.H 루틴	_UNICODE 및 _MBCS 정의되지 않음	정의된 _MBCS	정의된 _UNICODE
_tcsncicoll	_strnicoll	_mbsnbicoll	_wcsnicoll
_tcsnicoll	_strnicoll	_mbsnbicoll	_wcsnicoll
_tcsnicoll_l	_strnicoll_l	_mbsnbicoll_l	_wcsnicoll_l

요구 사항

루틴에서 반환된 값	필수 헤더
_strnicoll, _strnicoll_l	<string.h>
_wcsnicoll, _wcsnicoll_l	<wchar.h> 또는 <string.h>
_mbsnicoll, _mbsnicoll_l	<mbstring.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

참고 항목

Locale
문자열 조작
strcoll 함수
localeconv
_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll_mbsnbicoll_l
setlocale, _wsetlocale
strcmp, , wcscmp_mbscmp
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l_mbsicmp_l
strncmp, wcsncmp, _mbsncmp_mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l_mbsnicmp_l
strxfrm, wcsxfrm, _strxfrm_l_wcsxfrm_l