StrCmpNICW 함수(shlwapi.h)
ASCII(C 런타임) 데이터 정렬 규칙을 사용하여 두 문자열의 시작 부분에서 지정된 수의 문자를 비교합니다. 대/소문자를 구분하지 않고 비교합니다.
구문
int StrCmpNICW(
[in] LPCWSTR pszStr1,
[in] LPCWSTR 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 헤더는 STRCmpNIC를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shlwapi.h |
| 라이브러리 | Shlwapi.lib |
| DLL | Shlwapi.dll(버전 5.0 이상) |