Platform::String, klasa

Reprezentuje sekwencyjną kolekcję znaków Unicode używanych do reprezentowania tekstu. Aby uzyskać więcej informacji i przykładów, zobacz Ciągi.

Składnia

public ref class String sealed : Object,
    IDisposable,
    IEquatable,
    IPrintable

Iteratory

Dwie funkcje iteracyjne, które nie są elementami członkowskimi klasy String, mogą być używane z szablonem std::for_each funkcji do wyliczania znaków w obiekcie String.

Element członkowski	opis
const char16* begin(String^ s)	Zwraca wskaźnik na początek określonego obiektu String.
const char16* end(String^ s)	Zwraca wskaźnik obok końca określonego obiektu String.

Członkowie

Klasa String dziedziczy z obiektów i interfejsów IDisposable, IEquatable i IPrintable.

Klasa String ma również następujące typy składowych.

Konstruktory

Element członkowski	opis
String::String	Inicjuje nowe wystąpienie klasy String.

Metody

Klasa String dziedziczy metody Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() i ToString() z klasy Platform::Object. Ciąg zawiera również następujące metody.

Metoda	opis
Ciąg::Begin	Zwraca wskaźnik na początku bieżącego ciągu.
String::CompareOrdinal	Porównuje dwa String obiekty, oceniając wartości liczbowe odpowiadających im znaków w dwóch wartościach ciągu reprezentowanych przez obiekty.
Ciąg::Concat	Łączy wartości dwóch obiektów String.
Ciąg::D ata	Zwraca wskaźnik na początku bieżącego ciągu.
Ciąg::D ispose	Zwalnia lub zwalnia zasoby.
String::End	Zwraca wskaźnik obok końca bieżącego ciągu.
String::Equals	Wskazuje, czy określony obiekt jest równy bieżącemu obiektowi.
String::GetHashCode	Zwraca wartość skrótu dla tego wystąpienia.
Ciąg::IsEmpty	Wskazuje, czy bieżący obiekt String jest pusty.
String::IsFastPass	Wskazuje, czy bieżący obiekt String uczestniczy w operacji szybkiego przekazywania . W operacji szybkiego przekazywania zliczanie odwołań jest zawieszone.
Ciąg::Length	Pobiera długość bieżącego obiektu String.
String::ToString	Zwraca obiekt String, którego wartość jest taka sama jak bieżący ciąg.

Operatory

Klasa String ma następujące operatory.

Element członkowski	opis
String::operator==, operator	Wskazuje, czy dwa określone obiekty Ciąg mają tę samą wartość.
operator+ , operator	Łączy dwa obiekty String w nowy obiekt String.
String::operator, operator>	Wskazuje, czy wartość jednego obiektu String jest większa niż wartość drugiego obiektu String.
String::operator=, operator>	Wskazuje, czy wartość jednego obiektu String jest większa lub równa wartości drugiego obiektu String.
String::operator!= Operator	Wskazuje, czy dwa określone obiekty Ciąg mają różne wartości.
String::operator, operator<	Wskazuje, czy wartość jednego obiektu String jest mniejsza niż wartość drugiego obiektu String.

Wymagania

Minimalny obsługiwany klient: Windows 8

Minimalny obsługiwany serwer: Windows Server 2012

Przestrzeń nazw: Platforma

Nagłówek vccorlib.h (dołączony domyślnie)

String::Begin, metoda

Zwraca wskaźnik na początku bieżącego ciągu.

Składnia

char16* Begin();

Wartość zwracana

Wskaźnik na początku bieżącego ciągu.

String::CompareOrdinal, metoda

Metoda statyczna, która porównuje dwa String obiekty, oceniając wartości liczbowe odpowiadających im znaków w dwóch wartościach ciągu reprezentowanych przez obiekty.

Składnia

static int CompareOrdinal( String^ str1, String^ str2 );

Parametry

str1
Pierwszy obiekt String.

str2
Drugi obiekt String.

Wartość zwracana

Liczba całkowita wskazująca relację leksykalną między dwoma współzadami. W poniższej tabeli wymieniono możliwe wartości zwracane.

Wartość	Stan
-1	str1 wartość jest mniejsza niż str2.
0	str1 jest równa str2.
1	str1 wartość jest większa niż str2.

String::Concat, metoda

Łączy wartości dwóch obiektów String.

Składnia

String^ Concat( String^ str1, String^ str2);

Parametry

str1
Pierwszy obiekt String lub null.

str2
Drugi obiekt String lub null.

Wartość zwracana

Nowy obiekt String^, którego wartość jest łączeniem wartości i str1str2.

Jeśli str1 parametr jest null i str2 nie, str1 jest zwracany. Jeśli str2 parametr jest null i str1 nie, str2 jest zwracany. Jeśli str1 i str2 są , nullzwracany jest pusty ciąg (L").

String::D ata, metoda

Zwraca wskaźnik na początek buforu danych obiektu jako tablicę char16 w stylu C elementów (wchar_t).

Składnia

const char16* Data();

Wartość zwracana

Wskaźnik na początku const char16 tablicy znaków Unicode (char16 jest typedef dla wchar_t).

Uwagi

Użyj tej metody, aby przekonwertować element z Platform::String^ na wchar_t*. String Gdy obiekt wykracza poza zakres, wskaźnik danych nie jest już prawidłowy. Aby przechowywać dane poza okresem istnienia oryginalnego String obiektu, użyj wcscpy_s , aby skopiować tablicę do pamięci przydzielonej samodzielnie.

String::D ispose, metoda

Zwalnia lub zwalnia zasoby.

Składnia

virtual override void Dispose();

String::End, metoda

Zwraca wskaźnik obok końca bieżącego ciągu.

Składnia

char16* End();

Wartość zwracana

Wskaźnik wklejenia końca bieżącego ciągu.

Uwagi

Funkcja End() zwraca wartość Begin() + Length.

String::Equals, metoda

Wskazuje, czy określony ciąg ma taką samą wartość jak bieżący obiekt.

Składnia

bool String::Equals(Object^ str);
bool String::Equals(String^ str);

Parametry

Str
Obiekt do porównania.

Wartość zwracana

true jeśli str jest równy bieżącemu obiektowi; w przeciwnym razie false.

Uwagi

Ta metoda jest równoważna statycznej metodzie String::CompareOrdinal. W pierwszym przeciążeniu oczekuje str się, że parametr można rzutować do obiektu String^.

String::GetHashCode, metoda

Zwraca wartość skrótu dla tego wystąpienia.

Składnia

virtual override int GetHashCode();

Wartość zwracana

Kod skrótu dla tego wystąpienia.

String::IsEmpty, metoda

Wskazuje, czy bieżący obiekt String jest pusty.

Składnia

bool IsEmpty();

Wartość zwracana

truejeśli bieżący obiekt ma wartość null lub pusty ciąg (L""); w przeciwnym razie false.String

String::IsFastPass, metoda

Wskazuje, czy bieżący obiekt String uczestniczy w operacji szybkiego przekazywania . W operacji szybkiego przekazywania zliczanie odwołań jest zawieszone.

Składnia

bool IsFastPass();

Wartość zwracana

true jeśli bieżący String obiekt jest szybko wklejony; w przeciwnym razie false.

Uwagi

W wywołaniu funkcji, w której obiekt zliczany do odwołań jest parametrem, a wywoływana funkcja odczytuje tylko ten obiekt, kompilator może bezpiecznie zawiesić zliczanie odwołań i poprawić wydajność wywołań. Nie ma nic przydatnego, że kod może zrobić z tą właściwością. System obsługuje wszystkie szczegóły.

String::Length, metoda

Pobiera liczbę znaków w bieżącym String obiekcie.

Składnia

unsigned int Length();

Wartość zwracana

Liczba znaków w bieżącym String obiekcie.

Uwagi

Długość ciągu bez znaków wynosi zero. Długość następującego ciągu wynosi 5:

String^ str = "Hello";
int len = str->Length(); //len = 5

Tablica znaków zwracana przez ciąg::D ata ma jeden dodatkowy znak, który jest kończeniem wartości NULL lub "\0". Ten znak ma również długość dwóch bajtów.

String::operator+ Operator

Łączy dwa obiekty String w nowy obiekt String .

Składnia

bool String::operator+( String^ str1, String^ str2);

Parametry

str1
Pierwszy String obiekt.

str2
Drugi String obiekt, którego zawartość zostanie dołączona do str1obiektu .

Wartość zwracana

true jeśli wartość str1 jest równa str2; w przeciwnym razie false.

Uwagi

Ten operator tworzy String^ obiekt zawierający dane z dwóch operandów. Używaj go dla wygody, gdy ekstremalna wydajność nie jest krytyczna. Kilka wywołań "+" w funkcji prawdopodobnie nie będzie zauważalne, ale jeśli manipulujesz dużymi obiektami lub danymi tekstowymi w ścisłej pętli, użyj standardowych mechanizmów i typów języka C++.

String::operator==, operator

Wskazuje, czy dwa określone obiekty Ciąg mają tę samą wartość tekstową.

Składnia

bool String::operator==( String^ str1, String^ str2);

Parametry

str1
Pierwszy String obiekt do porównania.

str2
Drugi String obiekt do porównania.

Wartość zwracana

true jeśli zawartość str1 obiektu jest równa str2; w przeciwnym razie false.

Uwagi

Ten operator jest odpowiednikiem ciągu::CompareOrdinal.

String::operator>

Wskazuje, czy wartość jednego String obiektu jest większa niż wartość drugiego String obiektu.

Składnia

bool String::operator>( String^ str1, String^ str2);

Parametry

str1
Pierwszy String obiekt.

str2
Drugi String obiekt.

Wartość zwracana

true jeśli wartość str1 jest większa niż wartość str2; w przeciwnym razie false.

Uwagi

Ten operator jest odpowiednikiem jawnego wywoływania parametru String::CompareOrdinal i uzyskania wyniku większego niż zero.

String::operator>=

Wskazuje, czy wartość jednego String obiektu jest większa lub równa wartości drugiego String obiektu.

Składnia

bool String::operator>=( String^ str1, String^ str2);

Parametry

str1
Pierwszy String obiekt.

str2
Drugi String obiekt.

Wartość zwracana

true jeśli wartość str1 jest większa lub równa wartości str2; w przeciwnym razie false.

String::operator!=

Wskazuje, czy dwa określone String obiekty mają różne wartości.

Składnia

bool String::operator!=( String^ str1, String^ str2);

Parametry

str1
Pierwszy String obiekt do porównania.

str2
Drugi String obiekt do porównania.

Wartość zwracana

true jeśli str1 nie jest równe str2; w przeciwnym razie false.

String::operator<

Wskazuje, czy wartość jednego String obiektu jest mniejsza niż wartość drugiego String obiektu.

Składnia

bool String::operator<( String^ str1, String^ str2);

Parametry

str1
Pierwszy String obiekt.

str2
Drugi String obiekt.

Wartość zwracana

true jeśli wartość str1 jest mniejsza niż wartość str2; w przeciwnym razie false.

String::String, konstruktor

Inicjuje nowe wystąpienie String klasy przy użyciu kopii danych ciągu wejściowego.

Składnia

String();
String(char16* s);
String(char16* s, unsigned int n);

Parametry

s
Seria szerokich znaków, które inicjują ciąg. char16

N
Liczba określająca długość ciągu.

Uwagi

Jeśli wydajność jest krytyczna i kontrolujesz okres istnienia ciągu źródłowego, możesz użyć metody Platform::StringReference zamiast ciągu.

Przykład

String^ s = L"Hello!";

String::ToString

String Zwraca obiekt, którego wartość jest taka sama jak bieżący ciąg.

Składnia

String^ String::ToString();

Wartość zwracana

String Obiekt, którego wartość jest taka sama jak bieżący ciąg.

Zobacz też

Przestrzeń nazw platformy