Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::tolower — conversione in minuscolo

std::tolower di <cctype> converte un carattere in minuscolo secondo la locale C corrente. Per un valore di tipo char, convertilo prima in unsigned char e chiama la funzione solo se il valore risultante è rappresentabile come int.

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

Sintassi

#include <cctype>
int std::tolower(int c);

std::tolower di <cctype> accetta un int e restituisce come int il corrispondente carattere minuscolo, oppure lo stesso valore se la conversione non è possibile. Non modifica l’argomento: salva il risultato.

L’argomento deve essere uguale a EOF oppure avere un valore rappresentabile come unsigned char. Gli altri valori causano comportamento indefinito. Un normale char può essere negativo, quindi converti prima c con static_cast<unsigned char>(c). La chiamata std::tolower(static_cast<unsigned char>(c)) è valida per qualsiasi valore di tipo char se UCHAR_MAX <= INT_MAX (entrambe le costanti sono disponibili in <climits>). Altrimenti, prima della chiamata verifica che per il valore u di tipo unsigned char ottenuto valga u <= INT_MAX. In caso contrario, gestisci quel valore senza chiamare la funzione. La conversione di un valore fuori dall’intervallo di int al tipo del parametro può produrre un valore negativo: se è diverso da EOF, il comportamento è indefinito; se è uguale a EOF, la funzione non lo tratta come un carattere. Prima di convertire in unsigned char un valore di tipo int letto da uno stream, controlla che non sia EOF.

Il risultato dipende dalla locale C corrente. Non si tratta di una conversione delle maiuscole e minuscole Unicode né di una decodifica UTF-8. L’overload std::tolower(c, loc) di <locale> è distinto: usa std::ctype per l’oggetto locale fornito.

L’esempio elabora una stringa carattere per carattere e salva ogni risultato come char. Non controlla l’intervallo: presume che i valori ottenuti con la conversione in unsigned char siano rappresentabili come int. Non modifica la locale C iniziale. Non modificare le impostazioni globali tramite std::setlocale mentre si effettuano chiamate a questa funzione, a meno che non vi sia sincronizzazione.

Esempi

#include <cctype>
#include <iostream>
#include <string>

int main() {
    std::string text = "Hello, CPP23!";
    for (char& c : text) {
        c = static_cast<char>(std::tolower(static_cast<unsigned char>(c)));
    }
    std::cout << text << '\n';
}

Risultato

hello, cpp23!

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