Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła