Platform::String Sınıfı

Makale
10/12/2023

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	Tanım
`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	Tanım
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.

Yöntem	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	Tanım
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();

İade 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.

İade 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`.
Kategori 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.

İade Değeri

değeri ve str2değ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 nullisestr1, 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();

İade Değeri

Unicode karakter dizisinin başlangıcına yönelik bir const char16 işaretçi (char16 için wchar_tbir 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();

İade 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.

İade 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();

İade 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();

İade 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();

İade 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();

İade 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 str1eklenecek ikinci String nesne.

İade Değeri

truestr1 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.

İade 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.

İade Değeri

true değeri str1 değerinden str2bü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.

İade Değeri

true değerinin str1 değeri değerinden str2bü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.

İade Değeri

true eşit değilse str1str2; 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.

İade Değeri

truestr1 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();

İade Değeri

String Değeri geçerli dizeyle aynı olan bir nesne.

Ayrıca bkz.

Platform ad alanı