_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

아티클
06/09/2015

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

중요

_mbsicoll 와 _mbsicoll_l 는 Windows 런타임에서 실행되는 어플리케이션에서는 사용될 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 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
사용할 로캘입니다.

반환 값

각 이러한 함수들은 다음과 같이 string2*,* 로 string1 의 관계가 나태나는 값을 반환합니다.

반환 값	문자열 1과 문자열 2의 관계
< 0	string1 < string2
0	string1 = string2
> 0	string1 > string2
_NLSCMPERROR	오류가 발생했습니다.

이러한 각 함수를 _NLSCMPERROR 를 반환합니다. 이 _NLSCMPERROR 을 사용하면, 이 STRING.H 혹은 MBSTRING.H 어느쪽 역시 포함합니다. _wcsicoll 은 string1 혹은 string2 어느쪽은 대조하는 시퀀스의 도메인 외부의 와이드 문자 코드를 포함합니다. 오류가 발생하면, _wcsicoll 은 errno 을 EINVAL 으로 설정할 수 있습니다. 이 _wcsicoll 의 호출에서 오류를 확인하려면, _wcsicoll 을 호출한 후 errno 을 검사하고 errno 로 설정합니다.

설명

각 함수는 string1 대/소문자 구분 비교와 현재 사용중인 코드 페이지에 따라 string2 으로 수행합니다. 문자 사이는 차이점이 현재 코드 페이지에 순서와 lexicographic 문자 순서 설정 및 문자열 비교에 대한 관심의 차이가 있는 경우에 이러한 함수를 사용해야 합니다.

_stricmp 은, _stricoll 비교는 로캘의 LC_CTYPE 와 LC_COLLATE 범주들을 따르는데에 비해서, _stricmp 비교는 LC_CTYPE 로 영향을 받은 _stricoll 과는 다릅니다. 이 LC_COLLATE 범주의 더 많은 정보를 보려면, setlocale 와 Locale Categories을 보세요. _l 접미사가 없는 이러한 함수의 버전은 현재 로캘을 사용합니다; _l 접미사가 있는 버전은 대신 전달된 로캘을 사용한다는 것을 제외하고는 같습니다. 자세한 내용은 로캘을 참조하십시오.

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

제네릭 텍스트 라우팅 매핑