Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje