KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::wstring — een tekenreeks van wchar_t-elementen

std::wstring is een alias voor std::basic_string<wchar_t> uit <string>. Het beheert de opslag van de tekenreeks en ondersteunt toevoegen, vergelijken en toegang tot elementen. Een draagbare Unicode-codering wordt niet gegarandeerd.

Versie: C++23; repository compiler flag, production runtime not attested

Syntax

#include <string>
std::wstring text = L"Hello";

std::wstring is een alias voor std::basic_string<wchar_t> uit <string>. Het slaat een reeks wchar_t-elementen aaneengesloten op, beheert hun levensduur en maakt het mogelijk de lengte van de tekenreeks te wijzigen. Het voorvoegsel L maakt wide-literals: L"cat" is een stringliteral en L'C' een characterliteral.

size() geeft het aantal opgeslagen wchar_t-elementen terug, exclusief het afsluitende nul-element. Dit is doorgaans niet hetzelfde als het aantal Unicode-codepoints of door gebruikers waargenomen tekens. De breedte van wchar_t en de codering van wide-literals zijn afhankelijk van de implementatie; std::wstring garandeert noch UTF-16, noch UTF-32. Het converteert tekst uit std::string ook niet automatisch.

De operator += voegt tekst toe. at(i) biedt toegang tot een element met bereikcontrole en gooit std::out_of_range wanneer i >= size(). De methode c_str() geeft een pointer naar nulbeëindigde gegevens, nuttig voor interfaces die const wchar_t* accepteren. Een tekenreeks kan ook ingebedde nullen bevatten, maar een interface die uitsluitend op een terminator vertrouwt, beschouwt de eerste daarvan als het einde van de tekst.

Het voorbeeld maakt L"cat", voegt L"s" toe en wijzigt het eerste element. Met std::cout worden alleen de lengte en het vergelijkingsresultaat afgedrukt, zodat weergave van wide-tekst in de terminal niet nodig is. De verwachte regels zijn 4 en 1. Deze beschrijving behandelt bewerkingen die beschikbaar zijn in C++23; de opgegeven bron is een evoluerend normontwerp, geen vastgelegde C++23-publicatie.

Voorbeelden

#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';
}

Resultaat

4
1

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen