_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

아티클
06/09/2015

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

중요

_mbsncoll 와 _mbsncoll_l 는 Windows 런타임에 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 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, 으로 따르는 문자열의 관계를 나타내는 값을 반환합니다.

반환 값	문자열 1과 문자열 2의 관계
< 0	string1이 string2보다 작은 경우
0	string1 는 string2와 동일합니다.
> 0	string1가 string2보다 큰 경우

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

설명

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

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

제네릭 텍스트 라우팅 매핑