Platform::Kelas String

Mewakili kumpulan berurutan karakter Unicode yang digunakan untuk mewakili teks. Untuk informasi dan contoh selengkapnya, lihat String.

Sintaks

public ref class String sealed : Object,
    IDisposable,
    IEquatable,
    IPrintable

Iterator

Dua fungsi iterator, yang bukan anggota kelas String, dapat digunakan dengan std::for_each templat fungsi untuk menghitung karakter dalam objek String.

Anggota	Deskripsi
const char16* begin(String^ s)	Mengembalikan penunjuk ke awal objek String yang ditentukan.
const char16* end(String^ s)	Mengembalikan penunjuk melewati akhir objek String yang ditentukan.

Anggota

Kelas String mewarisi dari Antarmuka Object, dan IDisposable, IEquatable, dan IPrintable.

Kelas String juga memiliki jenis anggota berikut.

Konstruktor

Anggota	Deskripsi
String::String	Menginisialisasi instans baru kelas String.

Metode

Kelas String mewarisi metode Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose(), dan ToString() dari Platform::Object Class. String juga memiliki metode berikut.

Metode	Deskripsi
String::Begin	Mengembalikan penunjuk ke awal string saat ini.
String::CompareOrdinal	Membandingkan dua String objek dengan mengevaluasi nilai numerik karakter terkait dalam dua nilai string yang diwakili oleh objek.
String::Concat	Menggabungkan nilai dua objek String.
String::D ata	Mengembalikan penunjuk ke awal string saat ini.
String::D ispose	Membebaskan atau merilis sumber daya.
String::End	Mengembalikan penunjuk melewati akhir string saat ini.
String::Equals	Menunjukkan apakah objek yang ditentukan sama dengan objek saat ini.
String::GetHashCode	Mengembalikan kode hash untuk instans ini.
String::IsEmpty	Menunjukkan apakah objek String saat ini kosong.
String::IsFastPass	Menunjukkan apakah objek String saat ini berpartisipasi dalam operasi pass cepat. Dalam operasi pass cepat, penghitungan referensi ditangguhkan.
String::Length	Mengambil panjang objek String saat ini.
String::ToString	Mengembalikan objek String yang nilainya sama dengan string saat ini.

Operator

Kelas String memiliki operator berikut.

Anggota	Deskripsi
String::operator== Operator	Menunjukkan apakah dua objek String yang ditentukan memiliki nilai yang sama.
operator+ Operator	Menggabungkan dua objek String ke dalam objek String baru.
Operator String::operator>	Menunjukkan apakah nilai satu objek String lebih besar dari nilai objek String kedua.
String::operator>= Operator	Menunjukkan apakah nilai satu objek String lebih besar dari atau sama dengan nilai objek String kedua.
String::operator!= Operator	Menunjukkan apakah dua objek String yang ditentukan memiliki nilai yang berbeda.
Operator String::operator<	Menunjukkan apakah nilai satu objek String kurang dari nilai objek String kedua.

Persyaratan

Klien minimum yang didukung: Windows 8

Server minimum yang didukung: Windows Server 2012

Namespace: Platform

Header vccorlib.h (disertakan secara default)

String::Begin Method

Mengembalikan penunjuk ke awal string saat ini.

Sintaks

char16* Begin();

Tampilkan Nilai

Penunjuk ke awal string saat ini.

String::CompareOrdinal Method

Metode statis yang membandingkan dua String objek dengan mengevaluasi nilai numerik karakter terkait dalam dua nilai string yang diwakili oleh objek.

Sintaks

static int CompareOrdinal( String^ str1, String^ str2 );

Parameter

str1
Objek String pertama.

str2
Objek String kedua.

Tampilkan Nilai

Bilangan bulat yang menunjukkan hubungan leksikal antara dua perbandingan. Tabel berikut mencantumkan kemungkinan nilai pengembalian.

Nilai	Kondisi
-1	str1 kurang dari str2.
0	str1 sama dengan str2.
1	str1 lebih besar dari str2.

String::Metode Concat

Menggabungkan nilai dua objek String.

Sintaks

String^ Concat( String^ str1, String^ str2);

Parameter

str1
Objek String pertama, atau null.

str2
Objek String kedua, atau null.

Tampilkan Nilai

Objek String^ baru yang nilainya adalah perangkaian str1 nilai dan str2.

Jika str1 adalah null dan str2 tidak, str1 dikembalikan. Jika str2 adalah null dan str1 tidak, str2 dikembalikan. Jika str1 dan str2 keduanya , nullstring kosong (L"") dikembalikan.

String::D ata Method

Mengembalikan penunjuk ke awal buffer data objek sebagai array char16 elemen (wchar_t) gaya C.

Sintaks

const char16* Data();

Tampilkan Nilai

Penunjuk ke awal const char16 array karakter Unicode (char16 adalah typedef untuk wchar_t).

Keterangan

Gunakan metode ini untuk mengonversi dari Platform::String^ ke wchar_t*. String Ketika objek keluar dari cakupan, penunjuk Data tidak lagi dijamin valid. Untuk menyimpan data di luar masa pakai objek asli String , gunakan wcscpy_s untuk menyalin array ke dalam memori yang telah Anda alokasikan sendiri.

Metode String::D ispose

Membebaskan atau merilis sumber daya.

Sintaks

virtual override void Dispose();

String::End Method

Mengembalikan penunjuk melewati akhir string saat ini.

Sintaks

char16* End();

Tampilkan Nilai

Penunjuk untuk melewati akhir string saat ini.

Keterangan

End() mengembalikan Begin() + Length.

String::Equals Method

Menunjukkan apakah String yang ditentukan memiliki nilai yang sama dengan objek saat ini.

Sintaks

bool String::Equals(Object^ str);
bool String::Equals(String^ str);

Parameter

Str
Objek yang akan dibandingkan.

Tampilkan Nilai

true jika str sama dengan objek saat ini; jika tidak, false.

Keterangan

Metode ini setara dengan String statis ::CompareOrdinal. Pada kelebihan beban pertama, diharapkan str parameter dapat dilemparkan ke objek String^.

String::GetHashCode Method

Mengembalikan kode hash untuk instans ini.

Sintaks

virtual override int GetHashCode();

Tampilkan Nilai

Kode hash untuk instans ini.

String::Metode IsEmpty

Menunjukkan apakah objek String saat ini kosong.

Sintaks

bool IsEmpty();

Tampilkan Nilai

truejika objek saat ini String null atau string kosong (L""); jika tidak, false.

String::IsFastPass Method

Menunjukkan apakah objek String saat ini berpartisipasi dalam operasi pass cepat. Dalam operasi pass cepat, penghitungan referensi ditangguhkan.

Sintaks

bool IsFastPass();

Tampilkan Nilai

true jika objek saat ini String adalah masa lalu yang cepat; jika tidak, false.

Keterangan

Dalam panggilan ke fungsi di mana objek yang dihitung referensi adalah parameter, dan fungsi yang disebut hanya membaca objek tersebut, pengkompilasi dapat menangguhkan penghitungan referensi dengan aman dan meningkatkan performa panggilan. Tidak ada yang berguna yang dapat dilakukan kode Anda dengan properti ini. Sistem menangani semua detail.

String::Length Method

Mengambil jumlah karakter dalam objek saat ini String .

Sintaks

unsigned int Length();

Tampilkan Nilai

Jumlah karakter dalam objek saat ini String .

Keterangan

Panjang String tanpa karakter adalah nol. Panjang string berikut adalah 5:

String^ str = "Hello";
int len = str->Length(); //len = 5

Array karakter yang dikembalikan oleh String::D ata memiliki satu karakter tambahan, yaitu mengakhiri NULL atau '\0'. Karakter ini juga panjangnya dua byte.

String::operator+ Operator

Menggabungkan dua objek String ke dalam objek String baru.

Sintaks

bool String::operator+( String^ str1, String^ str2);

Parameter

str1
Objek pertama String .

str2
Objek kedua String , yang kontennya akan ditambahkan ke str1.

Tampilkan Nilai

true jika str1 sama dengan str2; jika tidak, false.

Keterangan

Operator ini membuat String^ objek yang berisi data dari dua operand. Gunakan untuk kenyamanan ketika performa ekstrem tidak penting. Beberapa panggilan ke "+" dalam fungsi mungkin tidak akan terlihat, tetapi jika Anda memanipulasi objek besar atau data teks dalam perulangan yang ketat, maka gunakan mekanisme dan jenis C++ standar.

String::operator== Operator

Menunjukkan apakah dua objek String yang ditentukan memiliki nilai teks yang sama.

Sintaks

bool String::operator==( String^ str1, String^ str2);

Parameter

str1
Objek pertama String yang dibandingkan.

str2
Objek kedua String yang akan dibandingkan.

Tampilkan Nilai

true jika isinya str1 sama dengan str2; jika tidak, false.

Keterangan

Operator ini setara dengan String::CompareOrdinal.

String::operator>

Menunjukkan apakah nilai satu String objek lebih besar dari nilai objek kedua String .

Sintaks

bool String::operator>( String^ str1, String^ str2);

Parameter

str1
Objek pertama String .

str2
Objek kedua String .

Tampilkan Nilai

true jika nilai lebih besar dari str1 nilai str2; jika tidak, false.

Keterangan

Operator ini setara dengan secara eksplisit memanggil String::CompareOrdinal dan mendapatkan hasil yang lebih besar dari nol.

String::operator>=

Menunjukkan apakah nilai satu String objek lebih besar dari atau sama dengan nilai objek kedua String .

Sintaks

bool String::operator>=( String^ str1, String^ str2);

Parameter

str1
Objek pertama String .

str2
Objek kedua String .

Tampilkan Nilai

true jika nilai str1 lebih besar dari atau sama dengan nilai str2; jika tidak, false.

String::operator!=

Menunjukkan apakah dua objek yang ditentukan String memiliki nilai yang berbeda.

Sintaks

bool String::operator!=( String^ str1, String^ str2);

Parameter

str1
Objek pertama String yang dibandingkan.

str2
Objek kedua String yang akan dibandingkan.

Tampilkan Nilai

true jika str1 tidak sama dengan str2; jika tidak, false.

String::operator<

Menunjukkan apakah nilai satu String objek kurang dari nilai objek kedua String .

Sintaks

bool String::operator<( String^ str1, String^ str2);

Parameter

str1
Objek pertama String .

str2
Objek kedua String .

Tampilkan Nilai

true jika nilai str1 kurang dari nilai str2; jika tidak, false.

String::String Constructor

Menginisialisasi instans String baru kelas dengan salinan data string input.

Sintaks

String();
String(char16* s);
String(char16* s, unsigned int n);

Parameter

s
Serangkaian karakter lebar yang menginisialisasi string. char16

n
Angka yang menentukan panjang string.

Keterangan

Jika performa sangat penting dan Anda mengontrol masa pakai string sumber, Anda dapat menggunakan Platform::StringReference sebagai pengganti String.

Contoh

String^ s = L"Hello!";

String::ToString

Mengembalikan String objek yang nilainya sama dengan string saat ini.

Sintaks

String^ String::ToString();

Tampilkan Nilai

Objek String yang nilainya sama dengan string saat ini.

Lihat juga

Namespace platform