Fungsi StrIsIntlEqualA (shlwapi.h)

Artikel
03/09/2024

Membandingkan jumlah karakter tertentu dari awal dua string untuk menentukan apakah karakter tersebut sama.

Sintaks

BOOL StrIsIntlEqualA(
       BOOL  fCaseSens,
  [in] PCSTR pszString1,
  [in] PCSTR pszString2,
       int   nChar
);

Parameter

fCaseSens

Jenis: BOOL

Sensitivitas kasus perbandingan. Jika nilai ini bukan nol, perbandingannya peka huruf besar/kecil. Jika nilai ini nol, perbandingannya tidak peka huruf besar/kecil.

[in] pszString1

Jenis: PCTSTR

Penunjuk ke string pertama yang dihentikan null untuk dibandingkan.

[in] pszString2

Jenis: PCTSTR

Penunjuk ke string kedua yang dihentikan null untuk dibandingkan.

nChar

Jenis: int

Jumlah karakter dari awal setiap string yang akan dibandingkan.

Nilai kembali

Jenis: BOOL

TRUE jika karakter nChar pertama dari dua string sama; jika tidak, FALSE.

Keterangan

Anda dapat mengatur sensitivitas huruf besar/kecil dengan makro StrIntlEqN dan StrIntlEqNI . StrIntlEqN melakukan perbandingan peka huruf besar/kecil, dan StrIntlEqNI melakukan perbandingan yang tidak peka huruf besar/kecil.

Sintaks kedua makro adalah:

#define StrIntlEqN(s1, s2, nChar) StrIsIntlEqual(TRUE, s1, s2, nChar)
#define StrIntlEqNI(s1, s2, nChar) StrIsIntlEqual(FALSE, s1, s2, nChar)

Catatan

Header shlwapi.h mendefinisikan StrIsIntlEqual sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 4.71 atau yang lebih baru)

Bagikan melalui