Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje