다음을 통해 공유


_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

대소문자와 상관없이 두 문자열의 문자를 비교합니다.

중요

_mbsnicmp 및 _mbsnicmp_l은 Windows 런타임에서 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 CRT 함수는 /ZW 옵션을 지원하지 않음을 참조하십시오.

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 함수는 string1 및 string2의 처음 count자까지를 서수로 비교합니다. 비교는 대소문자와 관계없이 각 문자를 소문자로 변환하여 수행됩니다. _strnicmp는 대소문자를 구분하지 않는 strncmp 버전입니다. count자를 비교하기 전에 두 문자열 중 하나에서 종결 null 문자에 도달하면 비교가 종료됩니다. count자를 비교하기 전에 두 문자열 중 하나에서 종결 null 문자에 도달할 때 문자열이 같으면 더 짧은 문자열이 더 작은 것으로 간주됩니다.

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

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

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

제네릭 텍스트 라우팅 매핑

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에 대한 예제를 참조하세요.

해당 .NET Framework 항목

System::String::Compare

참고 항목

참조

문자열 조작(CRT)

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