System::String sınıfı

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

Yöntemler

YöntemAçıklama
ASPOSECPP_VALUE_TYPE_IMPLEMENTS_INTERFACES()String C++ tarafında, kalıtım olmadan (örtülü olarak) bazı arayüzleri uygulayan bir değer tipidir.
begin() constGerçek dize tamponunun başlangıcına işaretçi döndürür. Hiçbir şeyi yeniden tahsis etmez. Tamponun null ile sonlandırılacağını garanti etmez.
Clone() constGeçerli dizenin bir kopyasını oluşturur.
static Compare(const String&, int, const String&, int, int, bool)Less-equal-greater iki alt dizeyi karşılaştırır.
static Compare(const String&, int, const String&, int, int, bool, const SharedPtr<System::Globalization::CultureInfo>&)Less-equal-greater iki alt dizeyi karşılaştırır.
static Compare(const String&, const String&, System::StringComparison)Less-equal-greater iki dizeyi karşılaştırır.
static Compare(const String&, int, const String&, int, int, System::StringComparison)Less-equal-greater iki dizeyi karşılaştırır.
static Compare(const String&, const String&, bool)Less-equal-greater iki dizeyi karşılaştırır.
static Compare(const String&, const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&)Less-equal-greater iki dizeyi karşılaştırır.
static CompareOrdinal(const String&, const String&)Less-equal-greater iki dizeyi sıralı modda karşılaştırır.
static CompareOrdinal(const String&, int, const String&, int, int)Less-equal-greater iki dizeyi sıralı modda karşılaştırır.
CompareTo(const String&) const’less-equals-more’ stilinde iki dizeyi karşılaştırır. Geçerli kültürü kullanır.
static Concat(const ArrayPtr<String>&)Dizeleri birleştirir.
static Concat(const String&, const String&)Dizeleri birleştirir.
static Concat(const String&, const String&, const String&)Dizeleri birleştirir.
static Concat(const String&, const String&, const String&, const String&)Dizeleri birleştirir.
Contains(const String&) conststr’nin geçerli dizenin bir alt dize olup olmadığını denetler.
Contains(char16_t) constDizenin verilen karakteri içerip içermediğini denetler.
static Copy(const String&)Dize kopyası oluşturur.
CopyTo(int, const ArrayPtr<char_t>&, int, int) constDize karakterlerini mevcut dizi öğelerine kopyalar. Yeniden boyutlandırma yapılmaz.
end() constGerçek dize tamponunun sonuna işaretçi döndürür. Hiçbir şeyi yeniden tahsis etmez. Tamponun null ile sonlandırılacağını garanti etmez.
EndsWith(const String&) constDizenin belirtilen alt dizeyle bitip bitmediğini denetler.
EndsWith(const String&, System::StringComparison) constDizenin belirtilen alt dizeyle bitip bitmediğini denetler.
EndsWith(const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&) constDizenin belirtilen alt dizeyle bitip bitmediğini denetler.
Equals(const String&, System::StringComparison) constString eşitlik karşılaştırması. StringComparison enumarasyonu tarafından sağlanan çeşitli modlar desteklenir.
Equals(const String&) constString eşitlik karşılaştırması. System::StringComparison::Ordinal karşılaştırma modunu kullanır.
static Equals(const String&, const String&)Equal iki dizeyi Ordial karşılaştırma modunu kullanarak karşılaştırır.
static Equals(const String&, const String&, System::StringComparison)Equal iki dizeyi karşılaştırır.
FastToAscii(char, int) constString nesnesini ASCII dizesine dönüştürmeye çalışır.
static Format(const SharedPtr<IFormatProvider>&, const String&, const Args&…)Dizeyi C# stilinde biçimlendirir.
static Format(std::nullptr_t, const String&, const Args&…)Dizeyi C# stilinde biçimlendirir.
static Format(std::nullptr_t, const char16_t(&), const Args&…)Dizeyi C# stilinde biçimlendirir.
static Format(const String&, const Args&…)Dizeyi C# stilinde biçimlendirir.
static Format(const String&, const System::ArrayPtr<T>&)Dizeyi C# stilinde biçimlendirir.
static FromAscii(const char *)ASCII dizesinden String oluşturur.
static FromAscii(const char *, int)ASCII dizesinden String oluşturur.
static FromAscii(const std::string&)ASCII dizesinden String oluşturur.
static FromUtf16(const std::u16string&)utf16 dizesinden String oluşturur.
static FromUtf32(const uint32_t *, int32_t)utf32 dizesinden String oluşturur.
static FromUtf8(const char *)utf8 dizesinden String oluşturur.
static FromUtf8(const char *, int)utf8 dizesinden String oluşturur.
static FromUtf8(const uint8_t *)utf8 dizesinden String oluşturur.
static FromUtf8(const std::string&)utf8 dizesinden String oluşturur.
static FromWCS(const std::wstring&)widestring’den String oluşturur.
get_Length() constDize uzunluğunu alır.
GetHashCode() constHash’leri içeren dize. ICU’da uygulanmıştır, C#‘deki hash’lerle eşleşmez.
IndexOf(const String&, System::StringComparison) constAlt dize ileri arama.
IndexOf(char_t, int) constKarakter ileri arama.
IndexOf(char_t, int, int) constAlt dizede karakter ileri arama.
IndexOf(const String&, int) constAlt dize ileri arama.
IndexOf(const String&, int, System::StringComparison) constAlt dize ileri arama.
IndexOf(const String&, int, int, System::StringComparison) constAlt dize ileri arama.
IndexOf(const String&, int, int) constAlt dize ileri arama.
IndexOfAny(char_t, int) constKarakter ileri arama.
IndexOfAny(const String&, int) constDolayısıyla bu içinde str’nin tüm karakterlerini arar. İlk karakter bulunursa konumu döndürülür, aksi takdirde ikinci karakteri ve böyle devam eder.
IndexOfAny(const ArrayPtr<char_t>&) constGeçilen karakterlerden herhangi birini tüm dize boyunca arar. İlk dize karakterini anyOf içindeki tüm karakterlerle karşılaştırır, ardından ikinci karakteri ve böyle devam eder. Hedef karakterlerden herhangi biriyle eşleşen ilk karakterin indeksini döndürür.
IndexOfAny(const ArrayPtr<char_t>&, int32_t) constGeçilen karakterlerden herhangi birini alt dize içinde arar. İlk dize karakterini anyOf içindeki tüm karakterlerle karşılaştırır, ardından ikinci karakteri ve böyle devam eder. Hedef karakterlerden herhangi biriyle eşleşen ilk karakterin indeksini döndürür.
IndexOfAny(const ArrayPtr<char_t>&, int32_t, int32_t) constGeçilen karakterlerden herhangi birini alt dize içinde arar. İlk dize karakterini anyOf içindeki tüm karakterlerle karşılaştırır, ardından ikinci karakteri ve böyle devam eder. Hedef karakterlerden herhangi biriyle eşleşen ilk karakterin indeksini döndürür.
Insert(int, const String&) constAlt diziyi belirtilen konuma ekler.
Is(const System::TypeInfo&) constGeçilen TypeInfo tarafından belirtilen türe sahip olup olmadığını string nesnesi kontrol eder.
IsAsciiString() constBir String yalnızca ASCII sembolleri içeriyorsa gösterir.
IsEmpty() constDizenin hem null olmaması hem de boş olması durumunu kontrol eder.
IsNormalized(System::Text::NormalizationForm) constUnicode dizenin belirtilen normalizasyon biçimi kullanılarak normalize edilip edilmediğini kontrol eder.
IsNull() constDizenin null olarak kabul edilip edilmediğini kontrol eder. String yalnızca String() yapıcısı ile oluşturulduğunda, taşındığında, kopyalandığında veya null dizeden atandığında ya da reset() yöntemi çağrıldığında null kabul edilir.
IsNullOrEmpty() constDizenin boş olup olmadığını veya null olarak kabul edilip edilmediğini kontrol eder.
static IsNullOrEmpty(const String&)Geçilen dizenin null veya boş olup olmadığını kontrol eder.
static IsNullOrWhiteSpace(const String&)Belirtilen dizenin null, boş veya yalnızca boşluk karakterlerinden oluşup oluşmadığını gösterir.
static Join(const String&, const ArrayPtr<String>&, int, int)Diziyi ayırıcı olarak string kullanarak birleştirir.
static Join(const String&, const System::Details::ArrayView<String>&, int, int)Diziyi ayırıcı olarak string kullanarak birleştirir.
static Join(const String&, const SharedPtr<System::Collections::Generic::IEnumerable<String>>&)Diziyi ayırıcı olarak string kullanarak birleştirir.
static Join(const String&, const ArrayPtr<SharedPtr<Object>>&)Diziyi ayırıcı olarak string kullanarak birleştirir.
LastIndexOf(const String&, int) constAlt dize geri arama.
LastIndexOf(const String&, System::StringComparison) constAlt dize geri arama.
LastIndexOf(const String&, int, System::StringComparison) constAlt dize geri arama.
LastIndexOf(const String&, int, int, StringComparison) constAlt dize geri arama.
LastIndexOf(char_t) constKarakter geri arama.
LastIndexOf(char_t, int32_t) constKarakter geri arama.
LastIndexOf(char_t, int32_t, int32_t) constKarakter geri arama.
LastIndexOfAny(const ArrayPtr<char_t>&) constGeçilen karakterlerden herhangi birini tüm dize içinde geriye doğru arar. Son dize karakterini anyOf içindeki tüm karakterlerle karşılaştırır, ardından bir önceki karakteri ve böyle devam eder. Bulunan ilk eşleşmenin indeksini döndürür.
LastIndexOfAny(const ArrayPtr<char_t>&, int32_t) constGeçilen karakterlerden herhangi birini alt dize içinde geriye doğru arar. Son dize karakterini anyOf içindeki tüm karakterlerle karşılaştırır, ardından bir önceki karakteri ve böyle devam eder. Bulunan ilk eşleşmenin indeksini döndürür.
LastIndexOfAny(const ArrayPtr<char_t>&, int32_t, int32_t) constGeçilen karakterlerden herhangi birini alt dize içinde geriye doğru arar. Son dize karakterini anyOf içindeki tüm karakterlerle karşılaştırır, ardından bir önceki karakteri ve böyle devam eder. Bulunan ilk eşleşmenin indeksini döndürür.
Normalize(System::Text::NormalizationForm) constBelirtilen normalizasyon biçimini kullanarak unicode dizesini normalize eder.
operator!=(const String&) constEşitsizlik karşılaştırma operatörü.
operator!=(std::nullptr_t) constDizenin null olmadığını kontrol eder. IsNull() çağrısındaki aynı mantığı uygular.
operator+(const String&) constString birleştirme operatörü.
operator+(const T&) constString dize sabiti veya karakter dize işaretçisiyle birleştirme.
operator+(char_t) constDizenin sonuna karakter ekler.
operator+(int) constDizenin sonuna tamsayı değerinin dize temsilini ekler.
operator+(uint32_t) constDizenin sonuna işaretsiz tamsayı değerinin dize temsilini ekler.
operator+(double) constDizenin sonuna kayan nokta değerinin dize temsilini ekler.
operator+(int64_t) constDizenin sonuna tamsayı değerinin dize temsilini ekler.
operator+(const T&) constDizenin sonuna referans tipindeki nesnenin dize temsilini ekler.
operator+(const T&) constDizenin sonuna referans tipindeki nesnenin dize temsilini ekler.
operator+(T) constDizenin sonuna boolean değerinin dize temsilini ekler.
operator+=(char_t)Birleştirme atama operatörü.
operator+=(const String&)Birleştirme atama operatörü.
operator+=(double)Birleştirme atama operatörü.
operator+=(uint8_t)Birleştirme atama operatörü.
operator+=(int16_t)Birleştirme atama operatörü.
operator+=(uint16_t)Birleştirme atama operatörü.
operator+=(int32_t)Birleştirme atama operatörü.
operator+=(uint32_t)Birleştirme atama operatörü.
operator+=(int64_t)Birleştirme atama operatörü.
operator+=(uint64_t)Birleştirme atama operatörü.
operator+=(T)Birleştirme atama operatörü.
operator<(const String&) constDizeleri sıralı olarak karşılaştırır.
operator=(const String&)Atama operatörü.
operator=(String&&)Taşıma atama operatörü.
operator==(const String&) constEşitlik karşılaştırma operatörü.
operator==(std::nullptr_t) constDizenin null olup olmadığını kontrol eder. Aynı mantığı IsNull() çağrısı gibi uygular.
operator>(const String&) constDizeleri sıralı olarak karşılaştırır.
operator[](int) constBelirtilen konumdaki karakteri alır.
PadLeft(int, char_t) constOrijinal dizenin sol tarafına doldurma ekler.
PadRight(int, char_t) constOrijinal dizenin sağ tarafına doldurma ekler.
rbegin() constGerçek dize tamponunun son karakterine (varsa) ters yineleyici döndürür.
Remove(int32_t, int32_t) constGeçerli dizgeden alt dize dışındaki her şeyi çıkarır.
rend() constGerçek dize tamponunun ilk karakterinden önceki konuma (varsa) ters yineleyici döndürür.
Replace(char_t, char_t) constDizedeki karakterin tüm görünümlerini değiştirir.
Replace(const String&, const String&) constBu dizgedeki arama değerinin tüm görünümlerini değiştirir.
reset()Dizeyi null olarak ayarlar. C#‘deki ‘string_degisken_adi = null’ ifadesine benzer.
SetCharAt(int, char_t)Belirtilen konumdaki karakteri ayarlar.
Split(char_t, StringSplitOptions) constDizeyi karaktere göre böler.
Split(char_t, int32_t, StringSplitOptions) constDizeyi karaktere göre böler.
Split(char_t, char_t, StringSplitOptions) constDizeyi iki karakterden birine göre böler.
Split(const ArrayPtr<char_t>&, StringSplitOptions) constBelirtilen karakterlerden biriyle dizeyi böler.
Split(const ArrayPtr<char_t>&, int32_t, StringSplitOptions) constBelirtilen karakterlerden biriyle dizeyi böler.
Split(const String&, StringSplitOptions) constDizeyi alt dizeye göre böler.
Split(const String&, int, StringSplitOptions) constDizeyi alt dizeye göre böler.
Split(const ArrayPtr<String>&, StringSplitOptions) constDizeyi alt dizeye göre böler.
Split(const ArrayPtr<String>&, int, StringSplitOptions) constDizeyi alt dizeye göre böler. Şu anda yalnızca sıfır veya bir öğe içeren ayırıcılar dizisini destekler.
StartsWith(const String&) constDizenin belirtilen alt dizeyle başlayıp başlamadığını kontrol eder.
StartsWith(const String&, System::StringComparison) constDizenin belirtilen alt dizeyle başlayıp başlamadığını kontrol eder.
StartsWith(const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&) constDizenin belirtilen alt dizeyle başlayıp başlamadığını kontrol eder.
String()Varsayılan yapıcı. Null olarak kabul edilen bir dize nesnesi oluşturur.
String(T&, typename std::enable_if<IsStringLiteral<T, char16_t>::value>::type *)Dizeyi dize sabiti temel alarak oluşturur. Sabiti null sonlu bir dize olarak kabul eder, hedef dize uzunluğunu sabit boyutuna göre hesaplar.
String(const T&, typename std::enable_if<IsStringPointer<T, char16_t>::value>::type *)Dizeyi karakter dize işaretçisine dayanarak oluşturur. İşaret edilen dizeyi null sonlu olarak kabul eder, hedef dize uzunluğunu null karakterine göre hesaplar.
explicit String(T&, typename std::enable_if<IsStringLiteral<T, char>::value>::type *)Dizeyi dize sabiti temel alarak oluşturur. Sabiti UTF8’de null sonlu bir dize olarak kabul eder, hedef dize uzunluğunu sabit boyutuna göre hesaplar.
explicit String(const T&, typename std::enable_if<IsStringPointer<T, char>::value>::type *)Dizeyi karakter dize işaretçisine dayanarak oluşturur. İşaret edilen dizeyi UTF8’de null sonlu olarak kabul eder, hedef dize uzunluğunu null karakterine göre hesaplar.
String(const char16_t *, int)Dizeyi karakter dize işaretçisinden ve açık uzunluktan oluşturur.
String(const char *, int)Dizeyi karakter dize işaretçisinden ve açık uzunluktan oluşturur.
String(const char16_t *, int, int)Dizeyi karakter dize işaretçisinin başlangıç konumundan uzunluk kullanarak oluşturur.
explicit String(const char16_t, int)Doldurma yapıcı.
String(const T&, typename std::enable_if<std::is_same<T, std::nullptr_t>::value>::type *)Nullptr yapıcı. Diğer şablon yapıcılarla öncelikleri çözmek için şablon olarak bildirilmiştir.
explicit String(T&, typename std::enable_if<IsStringLiteral<T, wchar_t>::value>::type *)Dizeyi geniş dize sabiti temel alarak oluşturur. Sabiti null sonlu bir dize olarak kabul eder, hedef dize uzunluğunu sabit boyutuna göre hesaplar. wchar_t dönüşümü bazı platformlarda zaman alıcıdır, bu yüzden örtük dönüşümlere izin verilmez.
explicit String(const T&, typename std::enable_if<IsStringPointer<T, wchar_t>::value>::type *)Dizeyi geniş karakter dize işaretçisine dayanarak oluşturur. İşaret edilen dizeyi null sonlu olarak kabul eder, hedef dize uzunluğunu null karakterine göre hesaplar. wchar_t dönüşümü bazı platformlarda zaman alıcıdır, bu yüzden örtük dönüşümlere izin verilmez.
explicit String(const wchar_t *, int)Dizeyi geniş karakter dize işaretçisinden ve açık uzunluktan oluşturur. wchar_t dönüşümü bazı platformlarda zaman alıcıdır, bu yüzden örtük dönüşümlere izin verilmez.
explicit String(const wchar_t, int)Doldurma yapıcı. wchar_t dönüşümü bazı platformlarda zaman alıcıdır, bu yüzden örtük dönüşümlere izin verilmez.
String(const String&)Kopya yapıcı.
String(String&&)Taşıma kurucusu.
String(const ArrayPtr<char16_t>&)Tüm karakter dizisini dizeye dönüştürür.
String(const ArrayPtr<char16_t>&, int, int)Karakter dizisinin alt aralığını dizeye dönüştürür. Parametreler dizi sınırları dışındaysa, boş bir dize oluşturulur.
explicit String(const codeporting_icu::UnicodeString&)UnicodeString’i String içine sarar.
explicit String(codeporting_icu::UnicodeString&&)Taşıma kurucusu.
explicit String(const std::wstring&)widestring’den String oluşturur.
explicit String(const std::u16string&)utf16 dizesinden String oluşturur.
explicit String(const std::string&)UTF-8 formatında sunulan std::string dizesinden String oluşturur.
explicit String(const std::u32string&)std::u32string dizesinden String oluşturur.
Substring(int32_t) constAlt dizeyi çıkarır.
Substring(int32_t, int32_t) constAlt dizeyi çıkarır.
ToAsciiString() constDizeyi std::string’e dönüştürür. ASCII kodlamasını kullanır.
ToByteArray(int32_t, int32_t, bool) constDizeyi veya alt dizeyi bayt dizisine dönüştürür.
ToCharArray(int32_t, int32_t) constDizeyi veya alt dizeyi karakter dizisine dönüştürür.
ToLower() constDizedeki tüm karakterleri küçük harfe dönüştürür.
ToLower(const SharedPtr<System::Globalization::CultureInfo>&) constDizedeki tüm karakterleri belirli bir kültür kullanarak küçük harfe dönüştürür.
ToLowerInvariant() constDizedeki tüm karakterleri değişmez kültür kullanarak küçük harfe dönüştürür.
ToString() constString sınıfını, değer türü nesnelerinde ToString() çağrıldığında işlemek için bir sarmalayıcı.
ToString(const SharedPtr<IFormatProvider>&) constString sınıfını, değer türü nesnelerinde ToString() çağrıldığında işlemek için bir sarmalayıcı.
ToU16Str() constDizeyi std::u16string’e dönüştürür.
ToU32Str() constDizeyi std::u32string’e dönüştürür.
ToUpper() constDizedeki tüm karakterleri büyük harfe dönüştürür.
ToUpper(const SharedPtr<System::Globalization::CultureInfo>&) constDizedeki tüm karakterleri belirli bir kültür kullanarak büyük harfe dönüştürür.
ToUpperInvariant() constDizedeki tüm karakterleri değişmez kültür kullanarak büyük harfe dönüştürür.
ToUtf8String() constDizeyi std::string’e dönüştürür. UTF-8 kodlamasını kullanır.
ToWCS() constDizeyi std::wstring’e dönüştürür.
Trim() constDizenin başından ve sonundan tüm boşluk karakterlerini kaldırır.
Trim(char_t) constDizenin başından ve sonundan verilen karakterin tüm tekrarlarını kaldırır.
Trim(const String&) constDizenin başından ve sonundan verilen karakterlerin tüm tekrarlarını kaldırır.
Trim(const ArrayPtr<char_t>&) constDizenin başından ve sonundan verilen karakterlerin tüm tekrarlarını kaldırır.
TrimEnd() constDizenin sonundan tüm boşluk karakterlerini kaldırır.
TrimEnd(char_t) constDizenin sonundan verilen karakterin tüm tekrarlarını kaldırır.
TrimEnd(const String&) constDizenin sonundan verilen karakterlerin tüm tekrarlarını kaldırır.
TrimEnd(const ArrayPtr<char_t>&) constDizenin sonundan verilen karakterlerin tüm tekrarlarını kaldırır.
TrimStart() constDizenin başından tüm boşluk karakterlerini kaldırır.
TrimStart(char_t) constDizenin başından verilen karakterin tüm tekrarlarını kaldırır.
TrimStart(const String&) constDizenin başından verilen karakterlerin tüm tekrarlarını kaldırır.
TrimStart(const ArrayPtr<char_t>&) constDizenin başından verilen karakterlerin tüm tekrarlarını kaldırır.
u_str() constICU tarzı null sonlandırmalı tampon döndürür. Dizeyi yeniden tahsis edebilir.
~String()Yıkıcı.

Alanlar

AlanAçıklama
static EmptyBoş dize.
static NullNull dize.

Typedefs

TypedefAçıklama
reverse_iteratorTers yineleyici türü.

Açıklamalar

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

int main()
{
  // Karakter dizisinden bir dize oluştur ve yazdır.
  const auto chars = {u'h', u'e', u'l', u'l', u'o'};
  const System::String string1(chars);
  std::cout << string1 << std::endl;

  // Bayt dizisinden bir dize oluşturun ve yazdırın.
  const uint8_t bytes[] = {0x77, 0x6f, 0x72, 0x6c, 0x64, 0x0};
  const auto string2 = System::String::FromUtf8(bytes);
  std::cout << string2 << std::endl;

  // Aşağıdaki dizeyi kırpın ve yazdırın.
  const System::String string3(u"   This string contains whitespaces in the beginning and at the end.   ");
  std::cout << '"' << string3.Trim() << '"' << std::endl;

  // Noktadaki kelime sayısını yazdırın.
  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
*/

Ayrıca Bakınız