Platform::String Sınıfı
Metni temsil etmek için kullanılan sıralı Unicode karakter koleksiyonunu temsil eder. Daha fazla bilgi ve örnek için bkz . Dizeler.
Sözdizimi
public ref class String sealed : Object,
IDisposable,
IEquatable,
IPrintable
Yineleyiciler
String sınıfının üyesi olmayan iki yineleyici işlevi, bir String nesnesindeki karakterleri numaralandırmak için işlev şablonuyla std::for_each
birlikte kullanılabilir.
Üye | Açıklama |
---|---|
const char16* begin(String^ s) |
Belirtilen String nesnesinin başına bir işaretçi döndürür. |
const char16* end(String^ s) |
Belirtilen String nesnesinin sonunu geçen bir işaretçi döndürür. |
Üyeler
String sınıfı Object ve IDisposable, IEquatable ve IPrintable arabirimlerinden devralınır.
String sınıfı ayrıca aşağıdaki üye türlerine sahiptir.
Oluşturucular
Üye | Açıklama |
---|---|
Dize::Dize | String sınıfının yeni bir örneğini başlatır. |
Yöntemler
String sınıfı Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() ve ToString() yöntemlerini Platform::Object Sınıfından devralır. Dize aşağıdaki yöntemlere de sahiptir.
Metot | Açıklama |
---|---|
Dize::Begin | Geçerli dizenin başına bir işaretçi döndürür. |
Dize::CompareOrdinal | Nesneler tarafından temsil edilen iki String dize değerinde karşılık gelen karakterlerin sayısal değerlerini değerlendirerek iki nesneyi karşılaştırır. |
Dize::Concat | İki String nesnesinin değerlerini birleştirir. |
Dize::D ata | Geçerli dizenin başına bir işaretçi döndürür. |
String::D ispose | Kaynakları serbest bırakır veya serbest bırakır. |
Dize::End | Geçerli dizenin sonunu geçen bir işaretçi döndürür. |
Dize::Eşittir | Belirtilen nesnenin geçerli nesneye eşit olup olmadığını gösterir. |
Dize::GetHashCode | Bu örneğe ilişkin karma kodu döndürür. |
Dize::IsEmpty | Geçerli String nesnesinin boş olup olmadığını gösterir. |
Dize::IsFastPass | Geçerli String nesnesinin hızlı geçiş işlemine katılıp katılmadığını gösterir. Hızlı geçiş işleminde başvuru sayımı askıya alınır. |
Dize::Uzunluk | Geçerli String nesnesinin uzunluğunu alır. |
Dize::ToString | Değeri geçerli dizeyle aynı olan bir String nesnesi döndürür. |
İşleçler
String sınıfı aşağıdaki işleçlere sahiptir.
Üye | Açıklama |
---|---|
String::operator== İşleci | Belirtilen iki String nesnesinin aynı değere sahip olup olmadığını gösterir. |
operator+ İşleci | İki String nesnesini yeni bir String nesnesiyle birleştirir. |
String::operator İşleci> | Bir String nesnesinin değerinin ikinci bir String nesnesinin değerinden büyük olup olmadığını gösterir. |
String::operator>= İşleci | Bir String nesnesinin değerinin ikinci bir String nesnesinin değerinden büyük veya buna eşit olup olmadığını gösterir. |
String::operator!= İşleci | Belirtilen iki String nesnesinin farklı değerlere sahip olup olmadığını gösterir. |
String::operator İşleci< | Bir String nesnesinin değerinin ikinci bir String nesnesinin değerinden küçük olup olmadığını gösterir. |
Gereksinimler
Desteklenen en düşük istemci: Windows 8
Desteklenen en düşük sunucu: Windows Server 2012
Ad Alanı: Platform
Üst bilgi vccorlib.h (varsayılan olarak dahildir)
String::Begin Yöntemi
Geçerli dizenin başına bir işaretçi döndürür.
Sözdizimi
char16* Begin();
Dönüş Değeri
Geçerli dizenin başlangıcına işaret eden bir işaretçi.
String::CompareOrdinal Yöntemi
Nesneler tarafından temsil edilen iki String
dize değerinde karşılık gelen karakterlerin sayısal değerlerini değerlendirerek iki nesneyi karşılaştıran statik yöntem.
Sözdizimi
static int CompareOrdinal( String^ str1, String^ str2 );
Parametreler
str1
İlk String nesnesi.
str2
İkinci String nesnesi.
Dönüş Değeri
İki karşılaştırma ve arasındaki sözcük temelli ilişkiyi gösteren bir tamsayı. Aşağıdaki tabloda olası dönüş değerleri listelemektedir.
Değer | Koşul |
---|---|
-1 | str1 değerinden str2 küçüktür. |
0 | str1 eşittir str2 . |
1 | str1 değerinden str2 büyüktür. |
String::Concat Yöntemi
İki String nesnesinin değerlerini birleştirir.
Sözdizimi
String^ Concat( String^ str1, String^ str2);
Parametreler
str1
İlk String nesnesi veya null
.
str2
İkinci String nesnesi veya null
.
Dönüş Değeri
değeri ve str2
değerlerinin str1
birleştirilmiş hali olan yeni bir String^ nesnesi.
null
Ise str1
ve str2
değilse, str1
döndürülür. null
Ise str2
ve str1
değilse, str2
döndürülür. ve str2
her ikisi de null
isestr1
, boş dize (L"") döndürülür.
String::D ata Yöntemi
Nesnenin veri arabelleğinin başına bir işaretçiyi C stilinde (wchar_t
) öğe dizisi char16
olarak döndürür.
Sözdizimi
const char16* Data();
Dönüş Değeri
Unicode karakter dizisinin başlangıcına yönelik bir const char16
işaretçi (char16
için wchar_t
bir tür tanımıdır).
Açıklamalar
'den'e Platform::String^
dönüştürmek için wchar_t*
bu yöntemi kullanın. Nesne kapsamın String
dışına çıktığında, Veri işaretçisinin artık geçerli olacağı garanti edilemeyecektir. Verileri özgün String
nesnenin ömrünün ötesinde depolamak için wcscpy_s kullanarak diziyi kendi ayırdığınız belleğe kopyalayın.
String::D ispose Yöntemi
Kaynakları serbest bırakır veya serbest bırakır.
Sözdizimi
virtual override void Dispose();
String::End Yöntemi
Geçerli dizenin sonunu geçen bir işaretçi döndürür.
Sözdizimi
char16* End();
Dönüş Değeri
Geçerli dizenin sonunu geçen bir işaretçi.
Açıklamalar
End(), Begin() + Length döndürür.
String::Equals Yöntemi
Belirtilen Dizenin geçerli nesneyle aynı değere sahip olup olmadığını gösterir.
Sözdizimi
bool String::Equals(Object^ str);
bool String::Equals(String^ str);
Parametreler
str
Karşılaştırma yapılacak nesne.
Dönüş Değeri
true
geçerli nesneye eşitse str
; değilse, false
.
Açıklamalar
Bu yöntem statik String::CompareOrdinal ile eşdeğerdir. İlk aşırı yüklemede, parametresinin str
bir String^ nesnesine atanabilmesi beklenir.
String::GetHashCode Yöntemi
Bu örneğe ilişkin karma kodu döndürür.
Sözdizimi
virtual override int GetHashCode();
Dönüş Değeri
Bu örneğin karma kodu.
String::IsEmpty Yöntemi
Geçerli String nesnesinin boş olup olmadığını gösterir.
Sözdizimi
bool IsEmpty();
Dönüş Değeri
true
geçerli String
nesne null ise veya boş dize (L""); değilse, false
.
String::IsFastPass Yöntemi
Geçerli String nesnesinin hızlı geçiş işlemine katılıp katılmadığını gösterir. Hızlı geçiş işleminde başvuru sayımı askıya alınır.
Sözdizimi
bool IsFastPass();
Dönüş Değeri
true
geçerli String
nesne hızlı geçmişse; değilse, false
.
Açıklamalar
Başvuru sayılan nesnenin parametre olduğu ve çağrılan işlevin yalnızca bu nesneyi okuduğu bir işlev çağrısında, derleyici başvuru sayımını güvenli bir şekilde askıya alabilir ve çağrı performansını iyileştirebilir. Kodunuzun bu özellik ile yapabilecekleri yararlı bir şey yoktur. Sistem tüm ayrıntıları işler.
String::Length Yöntemi
Geçerli String
nesnedeki karakter sayısını alır.
Sözdizimi
unsigned int Length();
Dönüş Değeri
Geçerli String
nesnedeki karakter sayısı.
Açıklamalar
Karakter içermeyen bir Dizenin uzunluğu sıfırdır. Aşağıdaki dizenin uzunluğu 5'tir:
String^ str = "Hello";
int len = str->Length(); //len = 5
String::D ata tarafından döndürülen karakter dizisinde null veya '\0' sonlandırıcı olan bir karakter daha vardır. Bu karakter aynı zamanda iki bayt uzunluğundadır.
String::operator+ İşleci
İki String nesnesini yeni bir String nesnesiyle birleştirir.
Sözdizimi
bool String::operator+( String^ str1, String^ str2);
Parametreler
str1
İlk String
nesne.
str2
İçeriği sonuna str1
eklenecek ikinci String
nesne.
Dönüş Değeri
true
str1 str2'ye eşitse, değilse, false
.
Açıklamalar
Bu işleç, iki işlenenden verileri içeren bir String^
nesne oluşturur. Aşırı performans kritik olmadığında kolaylık sağlamak için kullanın. İşlevdeki "+
" çağrısından birkaçı büyük olasılıkla dikkat çekici olmayacaktır, ancak büyük nesneleri veya metin verilerini sıkı bir döngüde işleyecekseniz standart C++ mekanizmalarını ve türlerini kullanın.
String::operator== İşleci
Belirtilen iki String nesnesinin aynı metin değerine sahip olup olmadığını gösterir.
Sözdizimi
bool String::operator==( String^ str1, String^ str2);
Parametreler
str1
Karşılaştıracak ilk String
nesne.
str2
Karşılaştıracak ikinci String
nesne.
Dönüş Değeri
true
içindekiler str1
öğesine eşitse str2
; değilse, false
.
Açıklamalar
Bu işleç String::CompareOrdinal ile eşdeğerdir.
String::operator>
Bir String
nesnenin değerinin ikinci String
bir nesnenin değerinden büyük olup olmadığını gösterir.
Sözdizimi
bool String::operator>( String^ str1, String^ str2);
Parametreler
str1
İlk String
nesne.
str2
İkinci String
nesne.
Dönüş Değeri
true
değeri str1
değerinden str2
büyükse; değilse, false
.
Açıklamalar
Bu işleç, String::CompareOrdinal öğesini açıkça çağırmaya ve sıfırdan büyük bir sonuç almaya eşdeğerdir.
String::operator>=
Bir String
nesnenin değerinin ikinci String
bir nesnenin değerinden büyük veya buna eşit olup olmadığını gösterir.
Sözdizimi
bool String::operator>=( String^ str1, String^ str2);
Parametreler
str1
İlk String
nesne.
str2
İkinci String
nesne.
Dönüş Değeri
true
değerinin str1
değeri değerinden str2
büyük veya buna eşitse; değilse, false
.
Dize::operator!=
Belirtilen String
iki nesnenin farklı değerlere sahip olup olmadığını gösterir.
Sözdizimi
bool String::operator!=( String^ str1, String^ str2);
Parametreler
str1
Karşılaştıracak ilk String
nesne.
str2
Karşılaştıracak ikinci String
nesne.
Dönüş Değeri
true
eşit değilse str1
str2
; değilse, false
.
String::operator<
Bir String
nesnenin değerinin ikinci String
bir nesnenin değerinden küçük olup olmadığını gösterir.
Sözdizimi
bool String::operator<( String^ str1, String^ str2);
Parametreler
str1
İlk String
nesne.
str2
İkinci String
nesne.
Dönüş Değeri
true
str1 değeri str2 değerinden küçükse, değilse , false
.
Dize::Dize Oluşturucu
Giriş dizesi verilerinin String
bir kopyasıyla sınıfının yeni bir örneğini başlatır.
Sözdizimi
String();
String(char16* s);
String(char16* s, unsigned int n);
Parametreler
s
Dizeyi başlatan bir dizi geniş karakter. char16
n
Dizenin uzunluğunu belirten bir sayı.
Açıklamalar
Performans kritikse ve kaynak dizenin yaşam ömrünü denetleyebilirsiniz, Dize yerine Platform::StringReference kullanabilirsiniz.
Örnek
String^ s = L"Hello!";
Dize::ToString
Değeri geçerli dizeyle aynı olan bir String
nesne döndürür.
Sözdizimi
String^ String::ToString();
Dönüş Değeri
String
Değeri geçerli dizeyle aynı olan bir nesne.