CKTIS / C++
std::wstring — napis z elementów wchar_t
std::wstring to zdefiniowany w <string> alias std::basic_string<wchar_t>. Zarządza pamięcią napisu i udostępnia operacje dopisywania, porównywania oraz dostępu do elementów. Nie gwarantuje przenośnego kodowania Unicode.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <string>
std::wstring text = L"Hello";std::wstring jest aliasem std::basic_string<wchar_t> z nagłówka <string>. Przechowuje ciąg elementów wchar_t w ciągłej pamięci, zarządza ich czasem życia i pozwala zmieniać długość napisu. Prefiks L tworzy szerokie literały: L"cat" jest literałem napisowym, a L'C' — znakowym.
size() zwraca liczbę przechowywanych elementów wchar_t, bez końcowego elementu zerowego. Nie jest to ogólnie liczba punktów kodowych Unicode ani znaków widocznych dla użytkownika. Szerokość wchar_t i kodowanie szerokich literałów zależą od implementacji; std::wstring nie gwarantuje UTF-16 ani UTF-32. Nie konwertuje też automatycznie tekstu z std::string.
Operator += dopisuje tekst, a at(i) udostępnia element z kontrolą zakresu i zgłasza std::out_of_range, gdy i >= size(). Metoda c_str() udostępnia wskaźnik do danych zakończonych zerem, przydatny dla interfejsów przyjmujących const wchar_t*. Napis może zawierać także wewnętrzne zera, ale interfejs oparty wyłącznie na terminatorze potraktuje pierwsze jako koniec tekstu.
Przykład tworzy L"cat", dopisuje L"s" i zmienia pierwszy element. Wypisuje przez std::cout wyłącznie długość i wynik porównania, więc nie wymaga wyświetlania szerokiego tekstu w terminalu. Oczekiwane linie to 4 i 1. Opis dotyczy operacji dostępnych w C++23; podane źródło jest rozwijanym szkicem standardu, a nie zamrożoną publikacją C++23.
Przykłady
#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';
}
Wynik
4 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.