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 değer tipidir ve (kalıtım olmadan) bazı arabirimleri örtük olarak uygular.
begin() constGerçek string tamponunun başlangıcına işaretçi döndürür. Hiçbir şeyi yeniden tahsis etmez. Tamponun null ile sonlandırılmasını garanti etmez.
Clone() constMevcut string’in 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 ordinal modda karşılaştırır.
static CompareOrdinal(const String&, int, const String&, int, int)Less-equal-greater iki dizeyi ordinal modda karşılaştırır.
CompareTo(const String&) constİki dizeyi ’less-equals-more’ stilinde karşılaştırır. Mevcut 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 mevcut string içinde bir alt dize olup olmadığını denetler.
Contains(char16_t) conststring’in verilen karakteri içerip içermediğini denetler.
static Copy(const String&)String kopyası oluşturur.
CopyTo(int, const ArrayPtr<char_t>&, int, int) constString karakterlerini mevcut dizi elemanlarına kopyalar. Yeniden boyutlandırma yapılmaz.
end() constGerçek string tamponunun sonuna işaretçi döndürür. Hiçbir zaman yeniden tahsis yapmaz. Tamponun null ile sonlandırılacağını garanti etmez.
EndsWith(const String&) constString’in belirtilen alt dizeyle bitip bitmediğini denetler.
EndsWith(const String&, System::StringComparison) constString’in belirtilen alt dizeyle bitip bitmediğini denetler.
EndsWith(const String&, bool, const SharedPtr<System::Globalization::CultureInfo>&) constString’in 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 birkaç mod 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 string’e dönüştürmeye çalışır.
static Format(const SharedPtr<IFormatProvider>&, const String&, const Args&…)String’i C# stilinde biçimlendirir.
static Format(std::nullptr_t, const String&, const Args&…)String’i C# stilinde biçimlendirir.
static Format(std::nullptr_t, const char16_t(&), const Args&…)String’i C# stilinde biçimlendirir.
static Format(const String&, const Args&…)String’i C# stilinde biçimlendirir.
static Format(const String&, const System::ArrayPtr<T>&)String’i C# stilinde biçimlendirir.
static FromAscii(const char *)ASCII string’den String oluşturur.
static FromAscii(const char *, int)ASCII string’den String oluşturur.
static FromAscii(const std::string&)ASCII string’den String oluşturur.
static FromUtf16(const std::u16string&)utf16 string’den String oluşturur.
static FromUtf32(const uint32_t *, int32_t)utf32 string’den String oluşturur.
static FromUtf8(const char *)utf8 string’den String oluşturur.
static FromUtf8(const char *, int)utf8 string’den String oluşturur.
static FromUtf8(const uint8_t *)utf8 string’den String oluşturur.
static FromUtf8(const std::string&)utf8 string’den String oluşturur.
static FromWCS(const std::wstring&)widestring’den String oluşturur.
get_Length() constString uzunluğunu alır.
GetHashCode() constİçerilen string’i hash’ler. ICU’da uygulanmıştır, C#‘daki 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) constSonuç olarak, 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çirilen karakterlerin herhangi birini tüm dizede 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çirilen karakterlerin herhangi birini alt dizede 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çirilen karakterlerin herhangi birini alt dizede 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çirilen TypeInfo tarafından belirtilen türe ait olup olmadığını kontrol eder.
IsAsciiString() constBir String yalnızca ASCII sembolleri içeriyorsa gösterir.
IsEmpty() constDizenin hem null olmayan hem de boş olup olmadığını 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şturulmuş, taşınmış, kopyalanmış veya null dizeden atanmış ya da reset() yöntemi çağrılmışsa null olur.
IsNullOrEmpty() constDizenin boş ya da null olarak kabul edilip edilmediğini kontrol eder.
static IsNullOrEmpty(const String&)Geçirilen dizenin null ya da 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 dize kullanarak birleştirir.
static Join(const String&, const System::Details::ArrayView<String>&, int, int)Diziyi ayırıcı olarak dize kullanarak birleştirir.
static Join(const String&, const SharedPtr<System::Collections::Generic::IEnumerable<String>>&)Diziyi ayırıcı olarak dize kullanarak birleştirir.
static Join(const String&, const ArrayPtr<SharedPtr<Object>>&)Diziyi ayırıcı olarak dize 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çirilen karakterlerin herhangi birini tüm dizede 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çirilen karakterlerin herhangi birini alt dizede 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çirilen karakterlerin herhangi birini alt dizede 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 dizeyi 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ı ile 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) constDizgenin sonuna karakter ekler.
operator+(int) constDizgenin sonuna tamsayı değerinin dize temsilini ekler.
operator+(uint32_t) constDizgenin sonuna işaretsiz tamsayı değerinin dize temsilini ekler.
operator+(double) constDizgenin sonuna kayan nokta değerinin dize temsilini ekler.
operator+(int64_t) constDizgenin sonuna tamsayı değerinin dize temsilini ekler.
operator+(const T&) constDizgenin sonuna referans tipindeki nesnenin dize temsilini ekler.
operator+(const T&) constDizgenin sonuna referans tipindeki nesnenin dize temsilini ekler.
operator+(T) constDizgenin 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&) constDizgileri sıralı 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) constDizgenin null olup olmadığını kontrol eder. Aynı mantığı IsNull() çağrısı gibi uygular.
operator>(const String&) constDizgileri sıralı karşılaştırır.
operator[](int) constBelirtilen konumdaki karakteri alır.
PadLeft(int, char_t) constOrijinal dizgenin sol tarafına doldurma ekler.
PadRight(int, char_t) constOrijinal dizgenin sağ tarafına doldurma ekler.
rbegin() constGerçek dize tamponunun son karakterine (varsa) ters yineleyici döndürür.
Remove(int32_t, int32_t) constMevcut dizgeden alt dize dışındaki her şeyi çıkarır.
rend() constGerçek dize tamponunun ilk karakterinden önceki (varsa) ters yineleyiciyi döndürür.
Replace(char_t, char_t) constDizgedeki 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()Dizgeyi null olarak ayarlar. C#‘deki ‘string_variable_name = null’ ifadesine benzer.
SetCharAt(int, char_t)Belirtilen konumdaki karakteri ayarlar.
Split(char_t, StringSplitOptions) constDizgeyi karaktere göre böler.
Split(char_t, int32_t, StringSplitOptions) constDizgeyi karaktere göre böler.
Split(char_t, char_t, StringSplitOptions) constDizgeyi iki karakterden birine göre böler.
Split(const ArrayPtr<char_t>&, StringSplitOptions) constDizgeyi belirtilen karakterlerden birine göre böler.
Split(const ArrayPtr<char_t>&, int32_t, StringSplitOptions) constDizgeyi belirtilen karakterlerden birine göre 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 öğeden oluşan 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çisi temel alarak 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çisi temel alarak 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çisi ve açık uzunluktan oluşturur.
String(const char *, int)Dizeyi karakter dize işaretçisi ve açık uzunluktan oluşturur.
String(const char16_t *, int, int)Dizeyi karakter dize işaretçisinden 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 bildirilir.
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çisi temel alarak 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çisi 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 string’den 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 diziyi bayt dizisine dönüştürür.
ToCharArray(int32_t, int32_t) constDizeyi veya alt diziyi karakter dizisine dönüştürür.
ToLower() constTüm dize karakterlerini küçük harfe dönüştürür.
ToLower(const SharedPtr<System::Globalization::CultureInfo>&) constTüm dize karakterlerini belirli bir kültür kullanarak küçük harfe dönüştürür.
ToLowerInvariant() constTüm dize karakterlerini değişmez kültür kullanarak küçük harfe dönüştürür.
ToString() constDeğer türü nesnelerinde ToString() çağrıldığında String sınıfını işlemek için bir sarmalayıcı.
ToString(const SharedPtr<IFormatProvider>&) constDeğer türü nesnelerinde ToString() çağrıldığında String sınıfını 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() constTüm dize karakterlerini büyük harfe dönüştürür.
ToUpper(const SharedPtr<System::Globalization::CultureInfo>&) constTüm dize karakterlerini belirli bir kültür kullanarak büyük harfe dönüştürür.
ToUpperInvariant() constTüm dize karakterlerini 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_iteratorReverse iterator 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ştur ve yazdır.
  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;

  // Metindeki 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