CKTIS / C++
std::tolower — conversion en minuscules
std::tolower de <cctype> convertit un caractère en minuscule selon la locale C actuelle. Pour une valeur de type char, convertissez-la d’abord en unsigned char et n’appelez la fonction que si le résultat est représentable par int.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cctype>
int std::tolower(int c);std::tolower de <cctype> prend un int et renvoie sous forme de int l’équivalent en minuscule, ou la valeur inchangée si aucune conversion n’est possible. La fonction ne modifie pas son argument : stockez le résultat.
L’argument doit être égal à EOF ou avoir une valeur représentable par unsigned char. Toute autre valeur entraîne un comportement indéfini. Un char ordinaire peut être négatif : convertissez donc d’abord c avec static_cast<unsigned char>(c). L’appel std::tolower(static_cast<unsigned char>(c)) est valide pour toute valeur de type char si UCHAR_MAX <= INT_MAX (les deux constantes sont disponibles dans <climits>). Sinon, vérifiez avant l’appel que la valeur u obtenue, de type unsigned char, satisfait u <= INT_MAX. Si ce n’est pas le cas, traitez cette valeur sans appeler la fonction. La conversion d’une valeur hors de l’intervalle représentable par int vers le type du paramètre peut produire une valeur négative : si elle est différente de EOF, le comportement est indéfini ; si elle est égale à EOF, la fonction ne la traite pas comme un caractère. Vérifiez qu’une valeur de flux de type int n’est pas égale à EOF avant de la convertir en unsigned char.
Le résultat dépend de la locale C actuelle. Il ne s’agit ni d’une conversion de casse Unicode ni d’un décodage UTF-8. La surcharge std::tolower(c, loc) de <locale> est distincte : elle utilise std::ctype pour l’objet locale fourni.
L’exemple traite une chaîne caractère par caractère et stocke chaque résultat sous forme de char. Il ne vérifie pas l’intervalle : il suppose que les valeurs obtenues après conversion en unsigned char sont représentables par int. Il ne modifie pas la locale C initiale. Ne modifiez pas les paramètres globaux avec std::setlocale en même temps que des appels à cette fonction sans synchronisation.
Exemples
#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';
}
Résultat
hello, cpp23!
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.