Freigeben über


Platform::String-Klasse

Stellt eine sequenzielle Auflistung von Unicode-Zeichen dar, die zum Darstellen von Text verwendet werden. Weitere Informationen und Beispiele finden Sie unter "Strings".

Syntax

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

Iterators

Zwei Iteratorfunktionen, die keine Member der String-Klasse sind, können mit der std::for_each Funktionsvorlage verwendet werden, um die Zeichen in einem String-Objekt aufzählen zu können.

Member Beschreibung
const char16* begin(String^ s) Gibt einen Zeiger auf den Anfang des angegebenen Zeichenfolgenobjekts zurück.
const char16* end(String^ s) Gibt einen Zeiger nach dem Ende des angegebenen Zeichenfolgenobjekts zurück.

Member

Die Zeichenfolgenklasse erbt vom Objekt und den Schnittstellen IDisposable, IEquatable und IPrintable.

Die Zeichenfolgenklasse verfügt auch über die folgenden Typen von Membern.

Konstruktoren

Member Beschreibung
String::String Initialisiert eine neue Instanz der Zeichenfolgenklasse.

Methoden

Die Zeichenfolgenklasse erbt die Methoden Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() und ToString() von Platform::Object Class. Die Zeichenfolge hat auch die folgenden Methoden.

Methode Beschreibung
String::Begin Gibt einen Zeiger auf den Anfang der aktuellen Zeichenfolge zurück.
String::CompareOrdinal Vergleicht zwei String -Objekte durch Auswertung der numerischen Werte der entsprechenden Zeichen in den beiden Zeichenfolgenwerten, die durch die Objekte dargestellt werden.
String::Concat Verkettet die Werte von zwei Zeichenfolgenobjekten.
String::D ata Gibt einen Zeiger auf den Anfang der aktuellen Zeichenfolge zurück.
String::D ispose Gibt Ressourcen frei.
String::End Gibt einen Zeiger nach dem Ende der aktuellen Zeichenfolge zurück.
String::Equals Gibt an, ob das angegebene Objekt gleich dem aktuellen Objekt ist.
String::GetHashCode Gibt den Hashcode für diese -Instanz zurück.
String::IsEmpty Gibt an, ob das aktuelle String-Objekt leer ist.
String::IsFastPass Gibt an, ob das aktuelle String -Objekt an einem Schnelldurchlaufvorgang teilnimmt. Bei einem Fast-Pass-Vorgang wird die Verweiszählung angehalten.
String::Length Ruft die Länge des aktuellen Zeichenfolgenobjekts ab.
String::ToString Gibt ein neues Zeichenfolgenobjekt zurück, dessen Wert mit der aktuellen Zeichenfolge identisch ist.

Operatoren

Die String-Klasse weist die folgenden Operatoren auf.

Member Beschreibung
String::operator== Operator Gibt an, ob zwei angegebene String-Objekte denselben Wert aufweisen.
operator+-Operator Verkettet zwei Zeichenfolgeobjekte in ein neues Zeichenfolgeobjekt.
String::operator-Operator> Gibt an, ob der Wert eines Zeichenfolgenobjekts größer als der Wert eines zweiten Zeichenfolgenobjekts ist.
String::operator>= Operator Gibt an, ob der Wert eines String-Objekts größer oder gleich dem Wert eines zweiten String-Objekts ist.
String::operator!= Operator Gibt an, ob zwei angegebene String-Objekte unterschiedliche Werte aufweisen.
String::operator-Operator< Gibt an, ob der Wert eines Zeichenfolgenobjekts kleiner als der Wert eines zweiten Zeichenfolgenobjekts ist.

Anforderungen

Mindestens unterstützter Client: Windows 8

Mindestens unterstützter Server: Windows Server 2012

Namespace: Platform

Header vccorlib.h (standardmäßig eingeschlossen)

String::Begin-Methode

Gibt einen Zeiger auf den Anfang der aktuellen Zeichenfolge zurück.

Syntax

char16* Begin();

Rückgabewert

Ein Zeiger auf den Anfang der aktuellen Zeichenfolge.

String::CompareOrdinal-Methode

Statische Methode, die zwei String Objekte vergleicht, indem die numerischen Werte der entsprechenden Zeichen in den beiden durch die Objekte dargestellten Zeichenfolgenwerten ausgewertet werden.

Syntax

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

Parameter

str1
Das erste String-Objekt.

str2
Das zweite String-Objekt.

Rückgabewert

Eine ganze Zahl, die die lexikalische Beziehung zwischen den beiden Vergleichswerten angibt. In der folgenden Tabelle sind die möglichen Rückgabewerte aufgelistet:

Wert Bedingung
-1 str1 ist kleiner als str2.
0 str1 ist gleich str2.
1 str1 ist größer als str2.

String::Concat-Methode

Verkettet die Werte von zwei Zeichenfolgenobjekten.

Syntax

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

Parameter

str1
Das erste Zeichenfolgenobjekt oder null.

str2
Das zweite Zeichenfolgenobjekt oder null.

Rückgabewert

Ein neues Zeichenfolgen^-Objekt, dessen Wert die Verkettung der Werte von str1 und str2 ist.

Wenn str1null und str2 ungleich null ist, wird str1 zurückgegeben. Wenn str2null und str1 ungleich null ist, wird str2 zurückgegeben. Wenn str1 und str2 beide null sind, wird die leere Zeichenfolge (L "") zurückgegeben.

String::Data-Methode

Gibt einen Zeiger zum Anfang des Datenpuffers des Objekts als ein Array im C-Format mit char16-Elementen (wchar_t) zurück.

Syntax

const char16* Data();

Rückgabewert

Ein Zeiger auf den Anfang eines const char16 Unicode-Zeichenarrays (char16 ist ein Typedef für wchar_t).

Hinweise

Verwenden Sie diese Methode zum Konvertieren von Platform::String^ zu wchar_t*. Wenn das String-Objekt den Gültigkeitsbereich verlässt, ist die Gültigkeit des Datenzeigers nicht mehr sichergestellt. Um die Daten über die Lebensdauer des ursprünglichen String Objekts hinaus zu speichern, verwenden Sie wcscpy_s , um das Array in den Arbeitsspeicher zu kopieren, den Sie selbst zugewiesen haben.

String::Dispose-Methode

Gibt Ressourcen frei.

Syntax

virtual override void Dispose();

String::End-Methode

Gibt einen Zeiger nach dem Ende der aktuellen Zeichenfolge zurück.

Syntax

char16* End();

Rückgabewert

Ein Zeiger zur Übergabe des Endes der aktuellen Zeichenfolge.

Hinweise

End() gibt Begin() + Length zurück.

String::Equals-Methode

Gibt an, ob die angegebene Zeichenfolge über den gleichen Wert wie das aktuelle Objekt verfügt.

Syntax

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

Parameter

str
Das zu vergleichende Objekt.

Rückgabewert

true, wenn str gleich dem aktuellen Objekt ist, andernfalls false.

Hinweise

Diese Methode entspricht der statischen Zeichenfolge::CompareOrdinal. In der ersten Überladung wird erwartet, dass der Parameter str zu einem String^-Objekt umgewandelt werden kann.

String::GetHashCode-Methode

Gibt den Hashcode für diese -Instanz zurück.

Syntax

virtual override int GetHashCode();

Rückgabewert

Der Hashcode für diese -Instanz.

String::IsEmpty-Methode

Gibt an, ob das aktuelle String-Objekt leer ist.

Syntax

bool IsEmpty();

Rückgabewert

truewenn das aktuelle String Objekt null oder die leere Zeichenfolge (L") ist; andernfalls false.

String::IsFastPass-Methode

Gibt an, ob das aktuelle String -Objekt an einem Schnelldurchlaufvorgang teilnimmt. Bei einem Fast-Pass-Vorgang wird die Verweiszählung angehalten.

Syntax

bool IsFastPass();

Rückgabewert

true wenn das aktuelle String Objekt schnell vorbei ist, andernfalls false.

Hinweise

Beim Aufruf einer Funktion, bei der ein Objekt mit Verweiszählung ein Parameter ist und die aufgerufene Funktion nur dieses Objekt liest, kann der Compiler die Verweiszählung sicher anhalten und die Aufrufleistung verbessern. Es gibt nichts nützliches, das Ihr Code mit dieser Eigenschaft ausführen kann. Das System behandelt alle Details.

String::Length-Methode

Ruft die Anzahl der Zeichen im aktuellen String Objekt ab.

Syntax

unsigned int Length();

Rückgabewert

Die Anzahl der Zeichen im aktuellen String Objekt.

Hinweise

Die Länge einer Zeichenfolge ohne Zeichen ist null. Die Länge der folgenden Zeichenfolge ist 5:

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

Das zeichenarray, das von string ::D ata zurückgegeben wird, weist ein zusätzliches Zeichen auf, bei dem es sich um das beendende NULL- oder '\0'-Zeichen handelt. Dieses Zeichen ist ebenfalls zwei Bytes lang.

String::operator+-Operator

Verkettet zwei String-Objekte in ein neues String-Objekt .

Syntax

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

Parameter

str1
Das erste String-Objekt.

str2
Das zweite String-Objekt, dessen Inhalt str1 angefügt wird.

Rückgabewert

truewenn str1 gleich str2 ist; andernfalls . false

Hinweise

Dieser Operator erstellt ein String^-Objekt mit den Daten aus den zwei Operanden. Verwenden Sie es zur Vereinfachung, wenn nicht unbedingt extreme Leistung gefordert ist. Einige Aufrufe von "+" in einer Funktion werden sich wahrscheinlich nicht bemerkbar machen. Wenn Sie jedoch große Objekte oder Textdaten in einer kurzen Schleife bearbeiten, sollten Sie die standardmäßigen C++-Mechanismen und -typen verwenden.

String::operator== Operator

Gibt an, ob zwei angegebene Zeichenfolgenobjekte denselben Textwert haben.

Syntax

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

Parameter

str1
Das erste zu vergleichende String-Objekt.

str2
Das zweite zu vergleichende String-Objekt.

Rückgabewert

truewenn der Inhalt str1 gleich str2ist ; andernfalls . false

Hinweise

Dieser Operator entspricht " String::CompareOrdinal".

String::operator>

Gibt an, ob der Wert eines String Objekts größer als der Wert eines zweiten String Objekts ist.

Syntax

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

Parameter

str1
Das erste String-Objekt.

str2
Das zweite String-Objekt.

Rückgabewert

true, wenn der Wert von str1 größer als der Wert von str2 ist, andernfalls false.

Hinweise

Dieser Operator entspricht dem expliziten Aufrufen von String::CompareOrdinal und dem Abrufen eines Ergebnisses größer als Null.

String::operator>=

Gibt an, ob der Wert eines String Objekts größer oder gleich dem Wert eines zweiten String Objekts ist.

Syntax

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

Parameter

str1
Das erste String-Objekt.

str2
Das zweite String-Objekt.

Rückgabewert

true, wenn der Wert von str1 größer oder gleich dem Wert von str2 ist, andernfalls false.

String::operator!=

Gibt an, ob zwei angegebene String Objekte unterschiedliche Werte aufweisen.

Syntax

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

Parameter

str1
Das erste zu vergleichende String-Objekt.

str2
Das zweite zu vergleichende String-Objekt.

Rückgabewert

true, wenn str1 und str2 ungleich sind, andernfalls false.

String::operator<

Gibt an, ob der Wert eines String Objekts kleiner als der Wert eines zweiten String Objekts ist.

Syntax

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

Parameter

str1
Das erste String-Objekt.

str2
Das zweite String-Objekt.

Rückgabewert

truewenn der Wert von str1 kleiner als der Wert von str2 ist; andernfalls . false

String::String-Konstruktor

Initialisiert eine neue Instanz der String Klasse mit einer Kopie der Eingabezeichenfolgendaten.

Syntax

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

Parameter

s
Eine Reihe von Breitzeichen, die die Zeichenfolge initialisieren. char16

n
Eine Zahl, die die Länge der Zeichenfolge angibt.

Hinweise

Wenn die Leistung wichtig ist und Sie die Lebensdauer der Quellzeichenfolge steuern, können Sie "Platform::StringReference" anstelle von "String" verwenden.

Beispiel

String^ s = L"Hello!";

String::ToString

Gibt ein String Objekt zurück, dessen Wert mit der aktuellen Zeichenfolge identisch ist.

Syntax

String^ String::ToString();

Rückgabewert

Ein String Objekt, dessen Wert mit der aktuellen Zeichenfolge identisch ist.

Siehe auch

Plattformnamespace