Kelas System::String

String class

String class used across the library. Is a substitute for C# System.String when translating code. For optimization reasons, isn’t considered an Object subclass. This type should be allocated on stack and passed to functions by value or by reference. Never use System::SmartPtr class to manage objects of this type.

class String

Metode

MetodeDeskripsi
ASPOSECPP_VALUE_TYPE_IMPLEMENTS_INTERFACES()String adalah tipe nilai di sisi C++ yang secara implisit (tanpa pewarisan) mengimplementasikan beberapa antarmuka.
begin() constMengembalikan pointer ke awal buffer string yang sebenarnya. Tidak pernah melakukan alokasi ulang apa pun. Tidak menjamin buffer berakhir dengan null.
Clone() constMembuat salinan string saat ini.
static Compare(const String&, int, const String&, int, int, bool)Less-equal-greater-membandingkan dua substring.
static Compare(const String&, int, const String&, int, int, bool, const SharedPtr<System::Globalization::CultureInfo>&)Less-equal-greater-membandingkan dua substring.
static Compare(const String&, const String&, System::StringComparison)Less-equal-greater-membandingkan dua string.
static Compare(const String&, int, const String&, int, int, System::StringComparison)Less-equal-greater-membandingkan dua string.
static Compare(const String&, const String&, bool)Less-equal-greater-membandingkan dua string.
static Compare(const String&, const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&)Less-equal-greater-membandingkan dua string.
static CompareOrdinal(const String&, const String&)Less-equal-greater-membandingkan dua string menggunakan mode ordinal.
static CompareOrdinal(const String&, int, const String&, int, int)Less-equal-greater-membandingkan dua string menggunakan mode ordinal.
CompareTo(const String&) constMembandingkan dua string dalam gaya ’less-equals-more’. Menggunakan budaya saat ini.
static Concat(const ArrayPtr<String>&)Menggabungkan string.
static Concat(const String&, const String&)Menggabungkan string.
static Concat(const String&, const String&, const String&)Menggabungkan string.
static Concat(const String&, const String&, const String&, const String&)Menggabungkan string.
Contains(const String&) constMemeriksa apakah str adalah substring dari string saat ini.
Contains(char16_t) constMemeriksa apakah string berisi karakter yang diberikan.
static Copy(const String&)Membuat salinan string.
CopyTo(int, const ArrayPtr<char_t>&, int, int) constMenyalin karakter string ke elemen array yang ada. Tidak ada perubahan ukuran yang dilakukan.
end() constMengembalikan pointer ke akhir buffer string yang sebenarnya. Tidak pernah melakukan alokasi ulang apa pun. Tidak menjamin buffer berakhir dengan null.
EndsWith(const String&) constMemeriksa apakah string diakhiri dengan substring yang ditentukan.
EndsWith(const String&, System::StringComparison) constMemeriksa apakah string diakhiri dengan substring yang ditentukan.
EndsWith(const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&) constMemeriksa apakah string diakhiri dengan substring yang ditentukan.
Equals(const String&, System::StringComparison) constString perbandingan kesetaraan. Beberapa mode yang disediakan oleh enumerasi StringComparison didukung.
Equals(const String&) constString perbandingan kesetaraan. Menggunakan mode perbandingan System::StringComparison::Ordinal.
static Equals(const String&, const String&)Equal-membandingkan dua string menggunakan mode perbandingan Ordial.
static Equals(const String&, const String&, System::StringComparison)Equal-membandingkan dua string.
FastToAscii(char, int) constMencoba mengonversi String menjadi string ASCII.
static Format(const SharedPtr<IFormatProvider>&, const String&, const Args&…)Memformat string dalam gaya C#.
static Format(std::nullptr_t, const String&, const Args&…)Memformat string dalam gaya C#.
static Format(std::nullptr_t, const char16_t(&), const Args&…)Memformat string dalam gaya C#.
static Format(const String&, const Args&…)Memformat string dalam gaya C#.
static Format(const String&, const System::ArrayPtr<T>&)Memformat string dalam gaya C#.
static FromAscii(const char *)Membuat String dari string ASCII.
static FromAscii(const char *, int)Membuat String dari string ASCII.
static FromAscii(const std::string&)Membuat String dari string ASCII.
static FromUtf16(const std::u16string&)Membuat String dari string utf16.
static FromUtf32(const uint32_t *, int32_t)Membuat String dari string utf32.
static FromUtf8(const char *)Membuat String dari string utf8.
static FromUtf8(const char *, int)Membuat String dari string utf8.
static FromUtf8(const uint8_t *)Membuat String dari string utf8.
static FromUtf8(const std::string&)Membuat String dari string utf8.
static FromWCS(const std::wstring&)Membuat String dari widestring.
get_Length() constMengambil panjang string.
GetHashCode() constString yang berisi hash. Diimplementasikan di ICU, tidak cocok dengan hash di C#.
IndexOf(const String&, System::StringComparison) constPencarian maju substring.
IndexOf(char_t, int) constPencarian maju karakter.
IndexOf(char_t, int, int) constPencarian maju karakter dalam substring.
IndexOf(const String&, int) constPencarian maju substring.
IndexOf(const String&, int, System::StringComparison) constPencarian maju substring.
IndexOf(const String&, int, int, System::StringComparison) constPencarian maju substring.
IndexOf(const String&, int, int) constPencarian maju substring.
IndexOfAny(char_t, int) constPencarian maju karakter.
IndexOfAny(const String&, int) constSecara konsekuen mencari semua karakter dari str dalam ini. Jika karakter pertama ditemukan, posisinya dikembalikan, jika tidak mencari karakter kedua dan seterusnya.
IndexOfAny(const ArrayPtr<char_t>&) constMencari salah satu karakter yang diberikan melalui seluruh string. Membandingkan karakter pertama string dengan semua karakter di anyOf, kemudian membandingkan yang kedua dan seterusnya. Mengembalikan indeks dari yang pertama yang cocok dengan salah satu karakter target.
IndexOfAny(const ArrayPtr<char_t>&, int32_t) constMencari salah satu karakter yang diberikan melalui substring. Membandingkan karakter pertama string dengan semua karakter di anyOf, kemudian membandingkan yang kedua dan seterusnya. Mengembalikan indeks dari yang pertama yang cocok dengan salah satu karakter target.
IndexOfAny(const ArrayPtr<char_t>&, int32_t, int32_t) constMencari salah satu karakter yang diberikan melalui substring. Membandingkan karakter pertama string dengan semua karakter di anyOf, kemudian membandingkan yang kedua dan seterusnya. Mengembalikan indeks dari yang pertama yang cocok dengan salah satu karakter target.
Insert(int, const String&) constMenyisipkan substring pada posisi yang ditentukan.
Is(const System::TypeInfo&) constMemeriksa apakah objek string berjenis tipe yang ditentukan oleh TypeInfo yang diberikan.
IsAsciiString() constMenunjukkan apakah sebuah String hanya berisi simbol ASCII.
IsEmpty() constMemeriksa apakah string tidak null dan kosong.
IsNormalized(System::Text::NormalizationForm) constMemeriksa apakah string unicode dinormalisasi menggunakan bentuk normalisasi yang ditentukan.
IsNull() constMemeriksa apakah string dianggap null. String adalah null hanya jika dibuat melalui konstruktor String(), dipindahkan, disalin atau ditetapkan dari string null atau metode reset() dipanggil.
IsNullOrEmpty() constMemeriksa apakah string kosong atau dianggap null.
static IsNullOrEmpty(const String&)Memeriksa apakah string yang diberikan null atau kosong.
static IsNullOrWhiteSpace(const String&)Menunjukkan apakah sebuah string yang ditentukan null, kosong, atau hanya terdiri dari karakter spasi putih.
static Join(const String&, const ArrayPtr<String>&, int, int)Menggabungkan array menggunakan string sebagai pemisah.
static Join(const String&, const System::Details::ArrayView<String>&, int, int)Menggabungkan array menggunakan string sebagai pemisah.
static Join(const String&, const SharedPtr<System::Collections::Generic::IEnumerable<String>>&)Menggabungkan array menggunakan string sebagai pemisah.
static Join(const String&, const ArrayPtr<SharedPtr<Object>>&)Menggabungkan array menggunakan string sebagai pemisah.
LastIndexOf(const String&, int) constPencarian mundur substring.
LastIndexOf(const String&, System::StringComparison) constPencarian mundur substring.
LastIndexOf(const String&, int, System::StringComparison) constPencarian mundur substring.
LastIndexOf(const String&, int, int, StringComparison) constPencarian mundur substring.
LastIndexOf(char_t) constPencarian mundur karakter.
LastIndexOf(char_t, int32_t) constPencarian mundur karakter.
LastIndexOf(char_t, int32_t, int32_t) constPencarian mundur karakter.
LastIndexOfAny(const ArrayPtr<char_t>&) constMencari salah satu karakter yang diberikan melalui seluruh string secara mundur. Membandingkan karakter terakhir string dengan semua karakter di anyOf, kemudian membandingkan yang sebelumnya dan seterusnya. Mengembalikan indeks dari kecocokan pertama yang ditemukan.
LastIndexOfAny(const ArrayPtr<char_t>&, int32_t) constMencari salah satu karakter yang diberikan melalui substring secara mundur. Membandingkan karakter terakhir string dengan semua karakter di anyOf, kemudian membandingkan yang sebelumnya dan seterusnya. Mengembalikan indeks dari kecocokan pertama yang ditemukan.
LastIndexOfAny(const ArrayPtr<char_t>&, int32_t, int32_t) constMencari salah satu karakter yang diberikan melalui substring secara mundur. Membandingkan karakter terakhir string dengan semua karakter di anyOf, kemudian membandingkan yang sebelumnya dan seterusnya. Mengembalikan indeks dari kecocokan pertama yang ditemukan.
Normalize(System::Text::NormalizationForm) constMenormalkan string unicode menggunakan bentuk normalisasi yang ditentukan.
operator!=(const String&) constOperator perbandingan tidak sama.
operator!=(std::nullptr_t) constMemeriksa apakah string tidak null. Menerapkan logika yang sama seperti pemanggilan IsNull().
operator+(const String&) constOperator penggabungan String.
operator+(const T&) constString penggabungan dengan literal string atau pointer string karakter.
operator+(char_t) constMenambahkan karakter ke akhir string.
operator+(int) constMenambahkan representasi string nilai integer ke akhir string.
operator+(uint32_t) constMenambahkan representasi string nilai integer tak bertanda ke akhir string.
operator+(double) constMenambahkan representasi string nilai titik mengambang ke akhir string.
operator+(int64_t) constMenambahkan representasi string nilai integer ke akhir string.
operator+(const T&) constMenambahkan representasi string objek tipe referensi ke akhir string.
operator+(const T&) constMenambahkan representasi string objek tipe referensi ke akhir string.
operator+(T) constMenambahkan representasi string nilai boolean ke akhir string.
operator+=(char_t)Operator penugasan penggabungan.
operator+=(const String&)Operator penugasan penggabungan.
operator+=(double)Operator penugasan penggabungan.
operator+=(uint8_t)Operator penugasan penggabungan.
operator+=(int16_t)Operator penugasan penggabungan.
operator+=(uint16_t)Operator penugasan penggabungan.
operator+=(int32_t)Operator penugasan penggabungan.
operator+=(uint32_t)Operator penugasan penggabungan.
operator+=(int64_t)Operator penugasan penggabungan.
operator+=(uint64_t)Operator penugasan penggabungan.
operator+=(T)Operator penugasan penggabungan.
operator<(const String&) constMembandingkan urutan string.
operator=(const String&)Operator penugasan.
operator=(String&&)Operator penugasan pindah.
operator==(const String&) constOperator perbandingan kesetaraan.
operator==(std::nullptr_t) constMemeriksa apakah string bernilai null. Menerapkan logika yang sama seperti pemanggilan IsNull().
operator>(const String&) constMembandingkan urutan string.
operator[](int) constMendapatkan karakter pada posisi yang ditentukan.
PadLeft(int, char_t) constMenambahkan padding di sebelah kiri string asli.
PadRight(int, char_t) constMenambahkan padding di sebelah kanan string asli.
rbegin() constMengembalikan iterator terbalik ke karakter terakhir (jika ada) dari buffer string aktual.
Remove(int32_t, int32_t) constMengekstrak semua kecuali substring dari string saat ini.
rend() constMengembalikan iterator terbalik ke sebelum karakter pertama (jika ada) dari buffer string aktual.
Replace(char_t, char_t) constMengganti semua kemunculan karakter dalam string.
Replace(const String&, const String&) constMengganti semua kemunculan pencarian dalam string ini.
reset()Mengatur string menjadi null. Seperti ‘string_variable_name = null’ dalam C#.
SetCharAt(int, char_t)Mengatur karakter pada posisi yang ditentukan.
Split(char_t, StringSplitOptions) constMembagi string berdasarkan karakter.
Split(char_t, int32_t, StringSplitOptions) constMembagi string berdasarkan karakter.
Split(char_t, char_t, StringSplitOptions) constMembagi string berdasarkan salah satu dari dua karakter.
Split(const ArrayPtr<char_t>&, StringSplitOptions) constMembagi string berdasarkan salah satu karakter yang ditentukan.
Split(const ArrayPtr<char_t>&, int32_t, StringSplitOptions) constMembagi string berdasarkan salah satu karakter yang ditentukan.
Split(const String&, StringSplitOptions) constMembagi string berdasarkan substring.
Split(const String&, int, StringSplitOptions) constMembagi string berdasarkan substring.
Split(const ArrayPtr<String>&, StringSplitOptions) constMembagi string berdasarkan substring.
Split(const ArrayPtr<String>&, int, StringSplitOptions) constMembagi string berdasarkan substring. Saat ini, hanya mendukung array pemisah dengan nol atau satu elemen.
StartsWith(const String&) constMemeriksa apakah string dimulai dengan substring yang ditentukan.
StartsWith(const String&, System::StringComparison) constMemeriksa apakah string dimulai dengan substring yang ditentukan.
StartsWith(const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&) constMemeriksa apakah string dimulai dengan substring yang ditentukan.
String()Konstruktor default. Membuat objek string yang dianggap null.
String(T&, typename std::enable_if<IsStringLiteral<T, char16_t>::value>::type *)Membuat string berdasarkan literal string. Menganggap literal sebagai string yang diakhiri null, menghitung panjang string target berdasarkan ukuran literal.
String(const T&, typename std::enable_if<IsStringPointer<T, char16_t>::value>::type *)Membuat string berdasarkan pointer string karakter. Menganggap string yang ditunjuk sebagai string yang diakhiri null, menghitung panjang string target berdasarkan karakter null.
explicit String(T&, typename std::enable_if<IsStringLiteral<T, char>::value>::type *)Membuat string berdasarkan literal string. Menganggap literal sebagai string yang diakhiri null dalam UTF8, menghitung panjang string target berdasarkan ukuran literal.
explicit String(const T&, typename std::enable_if<IsStringPointer<T, char>::value>::type *)Membuat string berdasarkan pointer string karakter. Menganggap string yang ditunjuk sebagai string yang diakhiri null dalam UTF8, menghitung panjang string target berdasarkan karakter null.
String(const char16_t *, int)Membuat string dari pointer string karakter dan panjang eksplisit.
String(const char *, int)Membuat string dari pointer string karakter dan panjang eksplisit.
String(const char16_t *, int, int)Membuat string dari pointer string karakter mulai dari posisi awal menggunakan panjang.
explicit String(const char16_t, int)Konstruktor pengisian.
String(const T&, typename std::enable_if<std::is_same<T, std::nullptr_t>::value>::type *)Konstruktor nullptr. Dideklarasikan sebagai templat untuk menyelesaikan prioritas dengan konstruktor templat lainnya.
explicit String(T&, typename std::enable_if<IsStringLiteral<T, wchar_t>::value>::type *)Membuat string berdasarkan literal widestring. Menganggap literal sebagai string yang diakhiri null, menghitung panjang string target berdasarkan ukuran literal. Konversi dari wchar_t memakan waktu pada beberapa platform, sehingga konversi implisit tidak diizinkan.
explicit String(const T&, typename std::enable_if<IsStringPointer<T, wchar_t>::value>::type *)Membuat string berdasarkan pointer string widecharacter. Menganggap string yang ditunjuk sebagai string yang diakhiri null, menghitung panjang string target berdasarkan karakter null. Konversi dari wchar_t memakan waktu pada beberapa platform, sehingga konversi implisit tidak diizinkan.
explicit String(const wchar_t *, int)Membuat string dari pointer string widecharacter dan panjang eksplisit. Konversi dari wchar_t memakan waktu pada beberapa platform, sehingga konversi implisit tidak diizinkan.
explicit String(const wchar_t, int)Konstruktor pengisian. Konversi dari wchar_t memakan waktu pada beberapa platform, sehingga konversi implisit tidak diizinkan.
String(const String&)Konstruktor penyalinan.
String(String&&)Konstruktor pemindahan.
String(const ArrayPtr<char16_t>&)Mengonversi seluruh array karakter menjadi string.
String(const ArrayPtr<char16_t>&, int, int)Mengonversi subrentang array karakter menjadi string. Jika parameter berada di luar batas array, string kosong akan dibuat.
explicit String(const codeporting_icu::UnicodeString&)Membungkus UnicodeString ke dalam String.
explicit String(codeporting_icu::UnicodeString&&)Konstruktor pemindahan.
explicit String(const std::wstring&)Membuat String dari widestring.
explicit String(const std::u16string&)Membuat String dari string utf16.
explicit String(const std::string&)Membuat String dari string std::string yang disajikan dalam format UTF-8.
explicit String(const std::u32string&)Membuat String dari string std::u32string.
Substring(int32_t) constMengekstrak substring.
Substring(int32_t, int32_t) constMengekstrak substring.
ToAsciiString() constMengonversi string menjadi std::string. Menggunakan enkoding ASCII.
ToByteArray(int32_t, int32_t, bool) constMengonversi string atau substring menjadi array byte.
ToCharArray(int32_t, int32_t) constMengonversi string atau substring menjadi array karakter.
ToLower() constMengonversi semua karakter string menjadi huruf kecil.
ToLower(const SharedPtr<System::Globalization::CultureInfo>&) constMengonversi semua karakter string menjadi huruf kecil menggunakan budaya tertentu.
ToLowerInvariant() constMengonversi semua karakter string menjadi huruf kecil menggunakan budaya invarian.
ToString() constPembungkus untuk menangani kelas String dalam konteks di mana ToString() dipanggil pada objek tipe nilai.
ToString(const SharedPtr<IFormatProvider>&) constPembungkus untuk menangani kelas String dalam konteks di mana ToString() dipanggil pada objek tipe nilai.
ToU16Str() constMengonversi string menjadi std::u16string.
ToU32Str() constMengonversi string menjadi std::u32string.
ToUpper() constMengonversi semua karakter string menjadi huruf besar.
ToUpper(const SharedPtr<System::Globalization::CultureInfo>&) constMengonversi semua karakter string menjadi huruf besar menggunakan budaya tertentu.
ToUpperInvariant() constMengonversi semua karakter string menjadi huruf besar menggunakan budaya invarian.
ToUtf8String() constMengonversi string menjadi std::string. Menggunakan enkoding UTF-8.
ToWCS() constMengonversi string menjadi std::wstring.
Trim() constMenghapus semua karakter spasi putih dari awal dan akhir string.
Trim(char_t) constMenghapus semua kemunculan karakter yang diberikan dari awal dan akhir string.
Trim(const String&) constMenghapus semua kemunculan karakter-karakter yang diberikan dari awal dan akhir string.
Trim(const ArrayPtr<char_t>&) constMenghapus semua kemunculan karakter-karakter yang diberikan dari awal dan akhir string.
TrimEnd() constMenghapus semua karakter spasi putih dari akhir string.
TrimEnd(char_t) constMenghapus semua kemunculan karakter yang diberikan dari akhir string.
TrimEnd(const String&) constMenghapus semua kemunculan karakter-karakter yang diberikan dari akhir string.
TrimEnd(const ArrayPtr<char_t>&) constMenghapus semua kemunculan karakter-karakter yang diberikan dari akhir string.
TrimStart() constMenghapus semua karakter spasi putih dari awal string.
TrimStart(char_t) constMenghapus semua kemunculan karakter yang diberikan dari awal string.
TrimStart(const String&) constMenghapus semua kemunculan karakter-karakter yang diberikan dari awal string.
TrimStart(const ArrayPtr<char_t>&) constMenghapus semua kemunculan karakter-karakter yang diberikan dari awal string.
u_str() constMengembalikan buffer null-terminated bergaya ICU. Mungkin akan mengalokasikan ulang string.
~String()Destruktor.

Bidang

BidangDeskripsi
static EmptyString kosong.
static NullString null.

Typedefs

TypedefDeskripsi
reverse_iteratorTipe iterator terbalik.

Catatan

#include "system/string.h"
#include <iostream>

int main()
{
  // Membuat string dari array karakter dan mencetaknya.
  const auto chars = {u'h', u'e', u'l', u'l', u'o'};
  const System::String string1(chars);
  std::cout << string1 << std::endl;

  // Bangun string dari array byte dan cetaknya.
  const uint8_t bytes[] = {0x77, 0x6f, 0x72, 0x6c, 0x64, 0x0};
  const auto string2 = System::String::FromUtf8(bytes);
  std::cout << string2 << std::endl;

  // Potong string di bawah ini dan cetaknya.
  const System::String string3(u"   This string contains whitespaces in the beginning and at the end.   ");
  std::cout << '"' << string3.Trim() << '"' << std::endl;

  // Cetak jumlah kata dalam .
  std::cout << "Number of words: " << string3.Trim().Split(' ')->get_Length() << std::endl;

  return 0;
}
/*
This code example produces the following output:
hello
world
"This string contains whitespaces in the beginning and at the end."
Number of words: 11
*/

Lihat Juga