CKTIS / C++
std::wstring — reťazec prvkov wchar_t
std::wstring je alias pre std::basic_string<wchar_t> definovaný v <string>. Spravuje úložisko reťazca a podporuje pridávanie, porovnávanie aj prístup k prvkom. Nezaručuje prenositeľné kódovanie Unicode.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <string>
std::wstring text = L"Hello";std::wstring je alias pre std::basic_string<wchar_t> z hlavičky <string>. Ukladá súvislú postupnosť prvkov wchar_t, spravuje ich životnosť a umožňuje meniť dĺžku reťazca. Prefix L vytvára wide literály: L"cat" je reťazcový literál a L'C' znakový literál.
size() vracia počet uložených prvkov wchar_t, bez koncového nulového prvku. Vo všeobecnosti to nie je počet kódových bodov Unicode ani znakov vnímaných používateľom. Šírka wchar_t aj kódovanie wide literálov závisia od implementácie; std::wstring nezaručuje UTF-16 ani UTF-32. Text z std::string tiež automaticky nekonvertuje.
Operátor += pridá text, zatiaľ čo at(i) poskytuje prístup k prvku s kontrolou hraníc a pri i >= size() vyhodí std::out_of_range. Metóda c_str() sprístupňuje ukazovateľ na údaje ukončené nulou, vhodný pre rozhrania prijímajúce const wchar_t*. Reťazec môže obsahovať aj nulové prvky vo svojom obsahu, ale rozhranie spoliehajúce sa výhradne na terminátor bude prvý z nich považovať za koniec textu.
Príklad vytvorí L"cat", pridá L"s" a zmení prvý prvok. Pomocou std::cout vypíše iba dĺžku a výsledok porovnania, takže netreba zobrazovať wide text v termináli. Očakávané riadky sú 4 a 1. Opis sa týka operácií dostupných v C++23; uvedený zdroj je priebežne sa vyvíjajúci návrh štandardu, nie nemenné vydanie C++23.
Prí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ýsledok
4 1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.