CKTIS / C++
std::wstring — řetězec prvků wchar_t
std::wstring je alias pro std::basic_string<wchar_t> definovaný v <string>. Spravuje úložiště řetězce a podporuje připojování, porovnávání i přístup k prvkům. Nezaručuje přenositelnou podobu kódování Unicode.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <string>
std::wstring text = L"Hello";std::wstring je alias pro std::basic_string<wchar_t> z hlavičky <string>. Ukládá souvislou posloupnost prvků wchar_t, spravuje jejich životnost a umožňuje měnit délku řetězce. Prefix L vytváří wide literály: L"cat" je řetězcový literál a L'C' znakový literál.
size() vrací počet uložených prvků wchar_t, bez koncového nulového prvku. Obecně nejde o počet bodů kódu Unicode ani o počet znaků vnímaných uživatelem. Šířka wchar_t i kódování wide literálů závisí na implementaci; std::wstring nezaručuje UTF-16 ani UTF-32. Text z std::string také automaticky nepřevádí.
Operátor += připojí text, zatímco at(i) poskytuje přístup k prvku s kontrolou mezí a při i >= size() vyvolá std::out_of_range. Metoda c_str() zpřístupňuje ukazatel na data zakončená nulou; hodí se pro rozhraní přijímající const wchar_t*. Řetězec může obsahovat i vložené nuly, ale rozhraní spoléhající pouze na terminátor bude první z nich považovat za konec textu.
Příklad vytvoří L"cat", připojí L"s" a změní první prvek. Pomocí std::cout vypisuje pouze délku a výsledek porovnání, takže není nutné zobrazovat wide text v terminálu. Očekávané řádky jsou 4 a 1. Popis se týká operací dostupných v C++23; uvedený zdroj je průběžně se vyvíjející návrh standardu, nikoli neměnné vydání C++23.
Příklady
#include <iostream>
#include <string>
int main() {
std::wstring text = L"cat";
text += L"s";
text.at(0) = L'C';
std::cout << text.size() << '\n';
std::cout << (text == L"Cats") << '\n';
}
Výsledek
4 1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.