_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

대/소문자에 상관없이 두 문자열에서 지정된 개수의 문자를 비교합니다.

Important

Windows 런타임에서 실행되는 애플리케이션에서는 _mbsnicmp 및 _mbsnicmp_l을 사용할 수는 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.

구문

int _strnicmp(
   const char *string1,
   const char *string2,
   size_t count
);
int _wcsnicmp(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count
);
int _mbsnicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);
int _strnicmp_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicmp_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsnicmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

매개 변수

string1, string2
비교할 Null 종료 문자열입니다.

count
비교할 문자 수입니다.

locale
사용할 로캘입니다.

반환 값

다음과 같이 부분 문자열 간의 관계를 나타냅니다.

반환 값	설명
< 0	string1 부분 문자열이 string2 부분 문자열보다 작습니다.
0	string1 부분 문자열이 string2 부분 문자열과 같습니다.
> 0	string1 부분 문자열이 string2 부분 문자열보다 큽니다.

매개 변수 유효성 검사 오류에서 이러한 함수는 string.h> 및 <mbstring.h>에 <정의된 반환_NLSCMPERROR합니다.

설명

함수는 _strnicmp 최대의 첫 번째 count 문자 string1 와 string2. 비교는 대소문자와 관계없이 각 문자를 소문자로 변환하여 수행됩니다. _strnicmp는 대소문자를 구분하지 않는 strncmp 버전입니다. count자를 비교하기 전에 두 문자열 중 하나에서 종결 null 문자에 도달하면 비교가 종료됩니다. count자를 비교하기 전에 두 문자열 중 하나에서 종결 null 문자에 도달할 때 문자열이 같으면 더 짧은 문자열이 더 작은 것으로 간주됩니다.

ASCII 테이블의 91에서 96까지의 문자('[', '\', ']', '^', '_', ''')는 영문자보다 작습니다. 이 순서 지정 방식은 stricmp의 방식과 같습니다.

_wcsnicmp 및 _mbsnicmp는 _strnicmp의 와이드 문자 및 멀티바이트 문자 버전입니다. 인수 _wcsnicmp 는 와이드 문자열입니다. 인수 _mbsnicmp 는 멀티바이트 문자열입니다. _mbsnicmp는 현재 멀티바이트 코드 페이지에 따라 멀티바이트 문자 시퀀스를 인식하며 오류 발생 시 _NLSCMPERROR를 반환합니다. 자세한 내용은 코드 페이지를 참조 하세요. 그렇지 않으면 이들 세 함수는 동일하게 작동합니다. 이러한 함수에는 로캘 설정이 적용됩니다. _l 접미사가 없는 버전은 로캘 종속 동작에서 현재 로캘을 사용하고 _l 접미사가 있는 버전은 전달되는 locale을 대신 사용합니다. 자세한 내용은 Locale을 참조하세요.

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

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

TCHAR.H 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_tcsncicmp	_strnicmp	_mbsnicmp	_wcsnicmp
_tcsnicmp	_strnicmp	_mbsnbicmp	_wcsnicmp
_tcsncicmp_l	_strnicmp_l	_mbsnicmp_l	_wcsnicmp_l

요구 사항

루틴에서 반환된 값	필수 헤더
_strnicmp, _strnicmp_l	<string.h>
_wcsnicmp, _wcsnicmp_l	<string.h> 또는 <wchar.h>
_mbsnicmp, _mbsnicmp_l	<mbstring.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

에 대한 예제를 strncmp참조하세요.

참고 항목

문자열 조작
strcat, wcscat, _mbscat
strcmp, wcscmp, _mbscmp
strcpy, wcscpy, _mbscpy
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l
_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l
strspn, wcsspn, _mbsspn, _mbsspn_l