StrCmpNICA 함수(shlwapi.h)

ASCII(C 런타임) 데이터 정렬 규칙을 사용하여 두 문자열의 시작 부분에서 지정된 수의 문자를 비교합니다. 대/소문자를 구분하지 않고 비교합니다.

구문

int StrCmpNICA(
  [in] LPCSTR pszStr1,
  [in] LPCSTR pszStr2,
       int    nChar
);

매개 변수

[in] pszStr1

형식: LPCTSTR

비교할 첫 번째 null로 끝나는 문자열에 대한 포인터입니다.

[in] pszStr2

형식: LPCTSTR

비교할 두 번째 null로 끝나는 문자열에 대한 포인터입니다.

nChar

형식: int

비교할 각 문자열의 시작 부분부터의 문자 수입니다.

반환 값

형식: int

부분 문자열이 동일하면 0을 반환합니다. pszStr1이 가리키는 에서 가져온 문자열이 pszStr2가 가리키는 문자열에서 가져온 문자열보다 사전순으로 크면 양수 값을 반환합니다. pszStr1이 가리키는 에서 가져온 문자열이 pszStr2가 가리키는 문자열보다 사전순으로 작으면 음수 값을 반환합니다.

설명

StrCmpNIC는 정식 문자열을 비교하도록 설계되었습니다. 이러한 문자열은 지역화되지 않으며 ASCII 값 128 미만의 문자로만 구성됩니다. 따라서 DBCS(더블바이트 문자 집합) 또는 기타 다중 문자 데이터에서는 제대로 작동하지 않습니다.

이 함수는 첫 번째 같지 않은 문자를 찾고 첫 번째 문자열의 문자가 두 번째 문자열의 문자보다 크면 양수를 반환하고, 작은 경우 음수를 반환하고, 같지 않으면 0을 반환합니다. 예를 들어 pszStr1="abczb", pszStr2="abcdefg"라고 가정하고 각 문자의 처음 네 문자를 비교한다고 가정합니다. StrCmpNIC 는 첫 번째 같지 않은 문자가 4( pszStr1 의 경우 "z", pszStr2의 경우 "d")에 있는지 확인하고 "z"에 대한 ASCII 코드가 "d"에 대한 ASCII 코드보다 크기 때문에 양수 값을 반환합니다.

Shlwapi.h에 StrCmpNIC 를 포함하지 않는 Windows 버전의 경우 이 함수의 개별 ANSI 또는 유니코드 버전은 Shlwapi.dll 직접 호출해야 합니다. StrCmpNICA 는 서수 153이고 StrCmpNICW 는 서수 154입니다.

참고

shlwapi.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 StrCmpNIC를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlwapi.h
라이브러리	Shlwapi.lib
DLL	Shlwapi.dll(버전 5.0 이상)

추가 정보

CompareString

StrCmpIC

StrCmpNI