Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::wstring — una stringa di elementi wchar_t

std::wstring è un alias di std::basic_string<wchar_t> definito in <string>. Gestisce la memoria della stringa e supporta l’aggiunta, il confronto e l’accesso agli elementi. Non garantisce una codifica Unicode portabile.

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

Sintassi

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

std::wstring è un alias di std::basic_string<wchar_t> definito in <string>. Memorizza in modo contiguo una sequenza di elementi wchar_t, ne gestisce la durata e consente di modificare la lunghezza della stringa. Il prefisso L crea literal wide: L"cat" è un literal stringa e L'C' è un literal carattere.

size() restituisce il numero di elementi wchar_t memorizzati, escluso l’elemento zero terminatore. In generale, questo numero non corrisponde né ai punti di codice Unicode né ai caratteri percepiti dall’utente. La larghezza di wchar_t e la codifica dei literal wide dipendono dall’implementazione; std::wstring non garantisce né UTF-16 né UTF-32. Inoltre, non converte automaticamente il testo da std::string.

L’operatore += aggiunge testo, mentre at(i) consente l’accesso agli elementi con controllo dei limiti e genera std::out_of_range quando i >= size(). Il metodo c_str() fornisce un puntatore a dati terminati da zero, utile per le interfacce che accettano const wchar_t*. Una stringa può contenere anche zeri incorporati, ma un’interfaccia che si basa soltanto su un terminatore considererà il primo come la fine del testo.

L’esempio crea L"cat", aggiunge L"s" e modifica il primo elemento. Usa std::cout per stampare soltanto la lunghezza e il risultato del confronto, quindi non richiede di visualizzare testo wide nel terminale. Le righe attese sono 4 e 1. Questa descrizione riguarda le operazioni disponibili in C++23; la fonte fornita è una bozza di standard in evoluzione, non una pubblicazione C++23 definitiva.

Esempi

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

Risultato

4
1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti