_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

아티클
06/09/2015

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

중요

_mbsnicoll 와 _mbsnicoll_l 는 Windows 런타임에서 실행되는 어플리케이션에서는 사용될 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 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 어느 쪽을 포함합니다. _wcsnicoll 은 string1 혹은 string2 어느쪽은 대조하는 시퀀스의 도메인 외부의 와이드 문자 코드를 포함합니다. 오류가 발생하면, _wcsnicoll 은 errno 을 EINVAL 으로 설정할 수 있습니다. 이 _wcsnicoll 의 호출에서 오류를 확인하려면, _wcsnicoll**.** 을 호출한 후 errno 을 검사하고 errno 로 설정합니다.

설명

이러한 함수들은 코드 페이지에 따라 string1 과 string2 인 첫 count 문자의 대/소문자 구분 비교를 수행합니다. 문자 사이는 차이점이 코드 페이지에 순서와 lexicographic 문자 순서 설정 및 문자열 비교에 대한 관심의 차이가 있는 경우에 이러한 함수를 사용해야 합니다. 이 _l 이 없는 이러한 함수들의 버전은 현재 로캘 및 코드 페이지를 사용 하는 접미사입니다. 이_l 접미사를 사용하여 버전에 전달 된 로케일을 사용 한다는 점을 제외 하면 동일 합니다. 자세한 내용은 로캘을 참조하십시오.

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

제네릭 텍스트 라우팅 매핑