Platform::String – třída

Představuje sekvenční kolekci znaků Unicode, které slouží k reprezentaci textu. Další informace a příklady naleznete v tématu Řetězce.

Syntaxe

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

Iterátory

Dvě iterátorové funkce, které nejsou členy třídy String, lze použít se std::for_each šablonou funkce k vytvoření výčtu znaků v objektu String.

Člen	Popis
const char16* begin(String^ s)	Vrátí ukazatel na začátek zadaného objektu String.
const char16* end(String^ s)	Vrátí ukazatel za konec zadaného objektu String.

Členové

String třída dědí z Object a IDisposable, IEquatable a IPrintable rozhraní.

Třída String má také následující typy členů.

Konstruktory

Člen	Popis
String::String	Inicializuje novou instanci Třídy String.

Metody

Třída String zdědí metody Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() a ToString() z třídy Platform::Object. Řetězec má také následující metody.

metoda	Popis
String::Begin	Vrátí ukazatel na začátek aktuálního řetězce.
String::CompareOrdinal	Porovná dva String objekty vyhodnocením číselných hodnot odpovídajících znaků ve dvou řetězcových hodnotách představovaných objekty.
String::Concat	Zřetězí hodnoty dvou objektů String.
String::D ata	Vrátí ukazatel na začátek aktuálního řetězce.
String::D ispose	Uvolní nebo uvolní prostředky.
String::End	Vrátí ukazatel za konec aktuálního řetězce.
String::Equals	Určuje, zda je zadaný objekt roven aktuálnímu objektu.
String::GetHashCode	Vrátí hodnotu hash pro tuto instanci.
String::IsEmpty	Určuje, zda je aktuální objekt String prázdný.
String::IsFastPass	Určuje, jestli se aktuální objekt String účastní operace rychlého průchodu. V operaci rychlého průchodu je počítání odkazů pozastaveno.
String::Length	Načte délku aktuálního objektu String.
String::ToString	Vrátí objekt String, jehož hodnota je stejná jako aktuální řetězec.

Operátory

Třída String má následující operátory.

Člen	Popis
String::operator== – operátor	Určuje, zda dva zadané objekty String mají stejnou hodnotu.
operator+ – operátor	Zřetězí dva objekty String do nového objektu String.
String::operator – operátor>	Určuje, zda hodnota jednoho objektu String je větší než hodnota druhého string objektu.
String::operator>= – operátor	Určuje, zda je hodnota jednoho objektu String větší nebo rovna hodnotě druhého objektu String.
String::operator!= – operátor	Určuje, zda dva zadané objekty String mají různé hodnoty.
String::operator – operátor<	Určuje, zda hodnota jednoho objektu String je menší než hodnota druhého string objektu.

Požadavky

Minimální podporovaný klient: Windows 8

Minimální podporovaný server: Windows Server 2012

Obor názvů: Platforma

Header vccorlib.h (zahrnutý ve výchozím nastavení)

String::Begin – metoda

Vrátí ukazatel na začátek aktuálního řetězce.

Syntaxe

char16* Begin();

Návratová hodnota

Ukazatel na začátek aktuálního řetězce.

String::CompareOrdinal – metoda

Statická metoda, která porovnává dva String objekty vyhodnocením číselných hodnot odpovídajících znaků ve dvou řetězcových hodnotách představovaných objekty.

Syntaxe

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

Parametry

str1
První objekt String.

str2
Druhý objekt String.

Návratová hodnota

Celé číslo, které označuje lexikální vztah mezi těmito dvěma srovnávacími čísly. Následující tabulka uvádí možné návratové hodnoty.

Hodnota	Podmínka
-1	str1 je menší než str2.
0	str1 je rovno str2.
0	str1 je větší než str2.

String::Concat – metoda

Zřetězí hodnoty dvou objektů String.

Syntaxe

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

Parametry

str1
První objekt String nebo null.

str2
Druhý objekt String nebo null.

Návratová hodnota

Nový string^ objekt, jehož hodnota je zřetězení hodnot a str1 str2.

Pokud str1 je null a str2 není, str1 vrátí se. Pokud str2 je null a str1 není, str2 vrátí se. Pokud str1 a jsou obanullstr2, vrátí se prázdný řetězec (L").

String::D ata – metoda

Vrátí ukazatel na začátek vyrovnávací paměti dat objektu jako pole char16 stylu C (wchar_t) prvků.

Syntaxe

const char16* Data();

Návratová hodnota

Ukazatel na začátek const char16 pole znaků Unicode (char16 je typedef pro wchar_t).

Poznámky

Pomocí této metody lze převést z Platform::String^ na wchar_t*. String Když objekt přestane být oborem, už není zaručeno, že datový ukazatel bude platný. Pokud chcete data uložit po dobu životnosti původního String objektu, použijte wcscpy_s ke zkopírování pole do paměti, kterou jste přidělili sami.

String::D ispose – metoda

Uvolní nebo uvolní prostředky.

Syntaxe

virtual override void Dispose();

String::End – metoda

Vrátí ukazatel za konec aktuálního řetězce.

Syntaxe

char16* End();

Návratová hodnota

Ukazatel na konec aktuálního řetězce

Poznámky

Funkce End() vrátí hodnotu Begin() + Length.

String::Equals – metoda

Určuje, zda zadaný řetězec má stejnou hodnotu jako aktuální objekt.

Syntaxe

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

Parametry

Str
Objekt k porovnání

Návratová hodnota

true je-li str rovna aktuálnímu objektu; falsev opačném případě .

Poznámky

Tato metoda je ekvivalentní statickému String::CompareOrdinal. V prvním přetížení je očekáváno str , že parametr lze přetypovat na String^ objektu.

String::GetHashCode – metoda

Vrátí hodnotu hash pro tuto instanci.

Syntaxe

virtual override int GetHashCode();

Návratová hodnota

Kód hash této instance

String::IsEmpty – metoda

Určuje, zda je aktuální objekt String prázdný.

Syntaxe

bool IsEmpty();

Návratová hodnota

truepokud je aktuální String objekt null nebo prázdný řetězec (L"); jinak , false.

String::IsFastPass – metoda

Určuje, jestli se aktuální objekt String účastní operace rychlého průchodu. V operaci rychlého průchodu je počítání odkazů pozastaveno.

Syntaxe

bool IsFastPass();

Návratová hodnota

true pokud je aktuální String objekt rychlý a v opačném případě false.

Poznámky

Při volání funkce, ve které je objekt počítaný odkazem parametr a volaná funkce tento objekt jen čte, kompilátor může bezpečně pozastavit počítání odkazů a zlepšit výkon volání. Pro tuto vlastnost není nic užitečného. Systém zpracovává všechny podrobnosti.

String::Length – metoda

Načte počet znaků v aktuálním String objektu.

Syntaxe

unsigned int Length();

Návratová hodnota

Počet znaků v aktuálním String objektu.

Poznámky

Délka řetězce bez znaků je nula. Délka následujícího řetězce je 5:

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

Pole znaků vrácené řetězcem::D ata má jeden další znak, což je ukončující hodnota NULL nebo \0. Tento znak je také dva bajty dlouhé.

String::operator+ – operátor

Zřetězí dva objekty String do nového objektu String .

Syntaxe

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

Parametry

str1
První String objekt.

str2
Druhý String objekt, jehož obsah bude připojen k str1.

Návratová hodnota

true je-li str1 roven str2; jinak , false.

Poznámky

Tento operátor vytvoří String^ objekt, který obsahuje data ze dvou operandů. Používejte ho pro pohodlí, když extrémní výkon není kritický. Několik volání+ "" ve funkci pravděpodobně nebude patrné, ale pokud pracujete s velkými objekty nebo textovými daty v těsné smyčce, použijte standardní mechanismy a typy jazyka C++.

String::operator== – operátor

Určuje, zda dva zadané objekty String mají stejnou textovou hodnotu.

Syntaxe

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

Parametry

str1
První String objekt, který se má porovnat.

str2
Druhý String objekt, který chcete porovnat.

Návratová hodnota

true je-li obsah str1 roven str2; v opačném případě false.

Poznámky

Tento operátor je ekvivalentní řetězci ::CompareOrdinal.

String::operator>

Určuje, zda je hodnota jednoho String objektu větší než hodnota druhého String objektu.

Syntaxe

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

Parametry

str1
První String objekt.

str2
Druhý String objekt.

Návratová hodnota

trueje-li hodnota větší než hodnota str1 str2; v opačném případě . false

Poznámky

Tento operátor je ekvivalentní explicitnímu volání String::CompareOrdinal a získání výsledku většího než nula.

String::operator>=

Určuje, zda je hodnota jednoho String objektu větší nebo rovna hodnotě druhého String objektu.

Syntaxe

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

Parametry

str1
První String objekt.

str2
Druhý String objekt.

Návratová hodnota

true je-li hodnota str1 větší nebo rovna hodnotě str2; v opačném případě , false.

String::operator!=

Určuje, zda dva zadané String objekty mají různé hodnoty.

Syntaxe

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

Parametry

str1
První String objekt, který se má porovnat.

str2
Druhý String objekt, který chcete porovnat.

Návratová hodnota

true pokud str1 není rovno str2; jinak , false.

String::operator<

Určuje, zda je hodnota jednoho String objektu menší než hodnota druhého String objektu.

Syntaxe

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

Parametry

str1
První String objekt.

str2
Druhý String objekt.

Návratová hodnota

trueje-li hodnota str1 menší než hodnota str2; v opačném případě . false

String::String – konstruktor

Inicializuje novou instanci String třídy s kopií vstupních řetězcových dat.

Syntaxe

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

Parametry

s
Řada širokých znaků, které inicializují řetězec. char16

n
Číslo, které určuje délku řetězce.

Poznámky

Pokud je výkon kritický a řídíte životnost zdrojového řetězce, můžete místo řetězce použít Platform::StringReference .

Příklad

String^ s = L"Hello!";

String::ToString

String Vrátí objekt, jehož hodnota je stejná jako aktuální řetězec.

Syntaxe

String^ String::ToString();

Návratová hodnota

Objekt String , jehož hodnota je stejná jako aktuální řetězec.

Viz také

Platform – obor názvů