Kelas CStringElementTraits

Kelas ini menyediakan fungsi statis yang digunakan oleh kelas koleksi yang CString menyimpan objek.

Sintaks

template <typename T>
class CStringElementTraits

Parameter

T
Jenis data yang akan disimpan dalam koleksi.

Anggota

Typedef Publik

Nama	Deskripsi
CStringElementTraits::INARGTYPE	Jenis data yang digunakan untuk menambahkan elemen ke objek kelas koleksi.
CStringElementTraits::OUTARGTYPE	Jenis data yang digunakan untuk mengambil elemen dari objek kelas koleksi.

Metode Publik

Nama	Deskripsi
CStringElementTraits::CompareElements	(Statis) Panggil fungsi ini untuk membandingkan dua elemen string untuk kesetaraan.
CStringElementTraits::CompareElementsOrdered	(Statis) Panggil fungsi ini untuk membandingkan dua elemen string.
CStringElementTraits::CopyElements	(Statis) Panggil fungsi ini untuk menyalin CString elemen yang disimpan dalam objek kelas koleksi.
CStringElementTraits::Hash	(Statis) Panggil fungsi ini untuk menghitung nilai hash untuk elemen string yang diberikan.
CStringElementTraits::RelocateElements	(Statis) Panggil fungsi ini untuk merelokasi CString elemen yang disimpan dalam objek kelas koleksi.

Keterangan

Kelas ini menyediakan fungsi statis untuk menyalin, memindahkan, dan membandingkan string dan untuk membuat nilai hash. Fungsi-fungsi ini berguna saat menggunakan kelas koleksi untuk menyimpan data berbasis string. Gunakan CStringElementTraitsI saat perbandingan tidak peka huruf besar/kecil diperlukan. Gunakan CStringRefElementTraits saat objek string akan ditangani sebagai referensi.

Untuk informasi selengkapnya, lihat Kelas Koleksi ATL.

Persyaratan

Header: cstringt.h

CStringElementTraits::CompareElements

Panggil fungsi statis ini untuk membandingkan dua elemen string untuk kesetaraan.

static bool CompareElements(INARGTYPE str1, INARGTYPE str2);

Parameter

str1
Elemen string pertama.

str2
Elemen string kedua.

Tampilkan Nilai

Mengembalikan true jika elemen sama, jika tidak salah.

CStringElementTraits::CompareElementsOrdered

Panggil fungsi statis ini untuk membandingkan dua elemen string.

static int CompareElementsOrdered(INARGTYPE str1, INARGTYPE str2);

Parameter

str1
Elemen string pertama.

str2
Elemen string kedua.

Tampilkan Nilai

Nol jika string identik, < 0 jika str1 kurang dari str2, atau > 0 jika str1 lebih besar dari str2. Metode CStringT::Compare digunakan untuk melakukan perbandingan.

CStringElementTraits::CopyElements

Panggil fungsi statis ini untuk menyalin CString elemen yang disimpan dalam objek kelas koleksi.

static void CopyElements(
    T* pDest,
    const T* pSrc,
    size_t nElements);

Parameter

pDest
Penunjuk ke elemen pertama yang akan menerima data yang disalin.

pSrc
Arahkan ke elemen pertama yang akan disalin.

nElements
Jumlah elemen yang akan disalin.

Keterangan

Elemen sumber dan tujuan tidak boleh tumpang tindih.

CStringElementTraits::Hash

Panggil fungsi statis ini untuk menghitung nilai hash untuk elemen string yang diberikan.

static ULONG Hash(INARGTYPE str);

Parameter

Str
Elemen string.

Tampilkan Nilai

Mengembalikan nilai hash, dihitung menggunakan konten string.

CStringElementTraits::INARGTYPE

Jenis data yang digunakan untuk menambahkan elemen ke objek kelas koleksi.

typedef T::PCXSTR INARGTYPE;

CStringElementTraits::OUTARGTYPE

Jenis data yang digunakan untuk mengambil elemen dari objek kelas koleksi.

typedef T& OUTARGTYPE;

CStringElementTraits::RelocateElements

Panggil fungsi statis ini untuk merelokasi CString elemen yang disimpan dalam objek kelas koleksi.

static void RelocateElements(
    T* pDest,
    T* pSrc,
    size_t nElements);

Parameter

pDest
Arahkan ke elemen pertama yang akan menerima data yang direlokasi.

pSrc
Arahkan ke elemen pertama untuk direlokasi.

nElements
Jumlah elemen yang akan direlokasi.

Keterangan

Fungsi statis ini memanggil memmove, yang cukup untuk sebagian besar jenis data. Jika objek yang dipindahkan berisi pointer ke anggota mereka sendiri, fungsi statis ini perlu ditimpa.

Lihat juga

Kelas CElementTraitsBase
Kelas CStringElementTraitsI
Gambaran Umum Kelas