CKTIS / C++
std::wstring — niz elementov wchar_t
std::wstring je vzdevek za std::basic_string<wchar_t>, določen v <string>. Upravlja shranjevanje niza ter podpira dodajanje, primerjanje in dostop do elementov. Ne zagotavlja prenosljivega kodiranja Unicode.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <string>
std::wstring text = L"Hello";std::wstring je vzdevek za std::basic_string<wchar_t> iz glave <string>. Zaporedje elementov wchar_t shranjuje strnjeno, upravlja njihovo življenjsko dobo in omogoča spreminjanje dolžine niza. Predpona L ustvari široke literale: L"cat" je nizovni literal, L'C' pa znakovni literal.
size() vrne število shranjenih elementov wchar_t, brez zaključnega ničelnega elementa. To praviloma ni število kodnih točk Unicode ali znakov, kot jih zaznava uporabnik. Širina wchar_t in kodiranje širokih literalov sta odvisna od implementacije; std::wstring ne zagotavlja niti UTF-16 niti UTF-32. Prav tako ne pretvarja samodejno besedila iz std::string.
Operator += doda besedilo, at(i) pa omogoča dostop do elementa s preverjanjem mej in sproži std::out_of_range, kadar velja i >= size(). Metoda c_str() zagotovi kazalec na podatke, zaključene z ničlo, uporaben za vmesnike, ki sprejemajo const wchar_t*. Niz lahko vsebuje tudi vdelane ničle, vendar bo vmesnik, ki se zanaša samo na zaključni znak, prvo obravnaval kot konec besedila.
Primer ustvari L"cat", doda L"s" in spremeni prvi element. Z std::cout izpiše samo dolžino in rezultat primerjave, zato prikaz širokega besedila v terminalu ni potreben. Pričakovani vrstici sta 4 in 1. Opis zajema operacije, ki so na voljo v C++23; navedeni vir je razvijajoči se osnutek standarda, ne nespremenjena objava C++23.
Primeri
#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';
}
Rezultat
4 1
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.