CKTIS / C++
std::toupper — convertire un carattere in maiuscolo
std::toupper di <cctype> restituisce il corrispondente carattere maiuscolo secondo le impostazioni locali C correnti. L’argomento deve essere uguale a EOF o rappresentabile come unsigned char; il tipo restituito è int.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <cctype>
int std::toupper(int c);std::toupper di <cctype> ha la firma int std::toupper(int c). Restituisce il carattere maiuscolo corrispondente secondo le impostazioni locali C correnti, oppure l’argomento invariato se non è possibile alcuna conversione. Non modifica l’argomento: assegna il risultato o utilizzalo in altro modo.
Il valore passato al parametro di tipo int deve essere uguale a EOF oppure rappresentabile come unsigned char. Qualsiasi altro valore causa un comportamento indefinito. Poiché un normale char può essere negativo, per una variabile di tipo char usa std::toupper(static_cast<unsigned char>(ch)) a condizione che il valore ottenuto dopo il cast sia rappresentabile come int. Se int non può rappresentare tutti i valori di unsigned char, prima della chiamata verifica che il valore ottenuto sia rappresentabile come int. In caso contrario, la conversione a int può produrre un valore negativo diverso da EOF e causare un comportamento indefinito. Se produce EOF, la funzione riceve EOF invece del valore del carattere. Se una funzione di input restituisce un valore di tipo int, controlla se è EOF prima di convertirlo in unsigned char.
L’esempio elabora una stringa un carattere alla volta e riconverte esplicitamente in char il risultato di tipo int. Presuppone che ogni valore ottenuto con il cast a unsigned char sia rappresentabile come int. Con le impostazioni locali iniziali "C", l’output previsto è HELLO, C++23! seguito da un carattere di nuova riga. Non è un meccanismo generale di conversione tra maiuscole e minuscole in Unicode: elaborare in questo modo i byte UTF-8 non è sufficiente.
Non confondere questa funzione con l’overload std::toupper(c, loc) di <locale>, che usa un oggetto delle impostazioni locali fornito esplicitamente. Le indicazioni precedenti sul cast a unsigned char si applicano alla funzione a un argomento di <cctype>.
Esempi
#include <cctype>
#include <iostream>
#include <string>
int main() {
std::string text = "Hello, C++23!";
for (char& ch : text) {
ch = static_cast<char>(
std::toupper(static_cast<unsigned char>(ch)));
}
std::cout << text << '\n';
}
Risultato
HELLO, C++23!
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.