Share via


_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

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

중요중요

_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, 두 문자열을 포함 합니다.MBSTRING H.H._wcsnicoll어느 경우에 실패할 수 있습니다 string1 또는 string2 와이드 문자 코드 도메인 외부 정렬 순서에 포함 되어 있습니다.오류가 발생 하면 _wcsnicoll 을 설정할 수 있습니다 errno 에 EINVAL.호출할 때 오류를 확인 하려면 _wcsnicoll설정 errno 0 다음 체크 errno 호출한 후 _wcsnicoll**.**

설명

이러한 각 함수는 첫 번째 대/소문자 구분 비교 count 문자 string1 및 string2 코드 페이지에 따라.문자 사이 시간차가 lexicographic 문자 순서 및 순서는 코드 페이지 설정 하 고 문자열 비교에 대 한 관심이 차이가 있을 때 이러한 함수를 사용 합니다.없이 이러한 함수 버전을 _l 접미사는 현재 로캘 및 코드 페이지를 사용 합니다.버전으로는_l 접미사는 대신 전달 된 로캘을 사용 하는 것을 제외 하 고 동일 합니다.자세한 내용은 로캘을 참조하십시오.

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

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴

_UNICODE 및 _Mbcs가 정의 되어 있지 않습니다

_Mbcs가 정의

_Unicode가 정의

_tcsncicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll_l

_strnicoll_l

_mbsnbicoll_l

_wcsnicoll_l

요구 사항

루틴

필수 헤더

_strnicoll, _strnicoll_l

<string.h>

_wcsnicoll, _wcsnicoll_l

<wchar.h> 또는 <string.h>

_mbsnicoll, _mbsnicoll_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