Share via


_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

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

중요중요

_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설정 errno 0 다음 체크 errno 호출 하면 _wcsncoll.

설명

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

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

일반 텍스트 루틴 매핑

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>

추가 호환성 정보를 참조 하십시오. 호환성.

해당 .NET Framework 항목

System::String::Compare

참고 항목

참조

로캘

문자열 조작 (CRT)

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