_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

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

Important

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

구문

int _strncoll(
   const char *string1,
   const char *string2,
   size_t count
);
int _wcsncoll(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count
);
int _mbsncoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);
int _strncoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsncoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsncoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

매개 변수

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

count
비교할 문자 수입니다.

locale
사용할 로캘입니다.

반환 값

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

반환 값	의 string1 관계 string2
< 0	string1가 string2보다 작은 경우
0	string1이 string2와 같은 경우
> 0	string1가 string2보다 큰 경우

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

설명

이러한 각 함수는 현재 사용 중인 코드 페이지에 따라 count 및 string1에 있는 첫 번째 string2 문자를 대/소문자를 구분하며 비교합니다. 코드 페이지에서 문자 집합 순서와 사전적 문자 순서가 다르고 문자열 비교에 이 차이가 중요한 경우에만 이러한 함수를 사용합니다. 문자 집합 순서는 로캘별로 다릅니다. _l 접미사가 없는 이러한 함수의 버전은 현재 로캘을 사용하지만 _l 접미사가 있는 버전은 전달되는 로캘을 사용합니다. 자세한 내용은 Locale을 참조하세요.

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

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

일반 텍스트 루틴 매핑

TCHAR.H 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_tcsnccoll	_strncoll	_mbsncoll	_wcsncoll
_tcsncoll	_strncoll	_mbsnbcoll	_wcsncoll

요구 사항

루틴에서 반환된 값	필수 헤더
_strncoll, _strncoll_l	<string.h>
_wcsncoll, _wcsncoll_l	<wchar.h> 또는 <string.h>
_mbsncoll, _mbsncoll_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