_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

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

Important

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

구문

int _stricoll(
   const char *string1,
   const char *string2
);
int _wcsicoll(
   const wchar_t *string1,
   const wchar_t *string2
);
int _mbsicoll(
   const unsigned char *string1,
   const unsigned char *string2
);
int _stricoll_l(
   const char *string1,
   const char *string2,
   _locale_t locale
);
int _wcsicoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale
);
int _mbsicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale
);

매개 변수

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

locale
사용할 로캘입니다.

반환 값

이러한 각 함수는 다음과 같이 관계를 나타내는 string1string2값을 반환합니다.

반환 값	의 string1 관계 string2
< 0	string1이 string2보다 짧음
0	string1 = string2
> 0	string1 > string2
_NLSCMPERROR	오류가 발생했습니다.

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

설명

이러한 각 함수는 현재 사용 중인 코드 페이지에 따라 string1과 string2를 대/소문자를 구분하지 않고 비교합니다. 이러한 함수는 현재 코드 페이지에서 문자 집합 순서와 사전적 문자 순서 사이에 차이가 있고 문자열 비교에 관심이 있는 경우에만 사용해야 합니다.

_stricmp는 _stricmp 비교가 LC_CTYPE의 영향을 받는다는 점에서 _stricoll과 다릅니다. 반면 _stricoll 비교는 로캘의 LC_CTYPE 및 LC_COLLATE 범주에 따라 수행됩니다. 범주에 대한 LC_COLLATE 자세한 내용은 범주 및 로캘을 참조 setlocale 하세요. _l 접미사가 없는 이러한 함수 버전은 현재 로캘을 사용하며, _l 접미사가 있는 버전은 전달된 로캘을 대신 사용한다는 점을 제외하면 동일합니다. 자세한 내용은 Locale을 참조하세요.

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

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

일반 텍스트 루틴 매핑

TCHAR.H 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_tcsicoll	_stricoll	_mbsicoll	_wcsicoll

요구 사항

루틴에서 반환된 값	필수 헤더
_stricoll, _stricoll_l	<string.h>
_wcsicoll, _wcsicoll_l	<wchar.h>, <string.h>
_mbsicoll, _mbsicoll_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