CKTIS / C++
std::toupper — convertir un caractère en majuscule
std::toupper de <cctype> renvoie l’équivalent majuscule d’un caractère selon la locale C actuelle. L’argument doit être égal à EOF ou représentable par unsigned char ; le type de retour est int.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cctype>
int std::toupper(int c);std::toupper de <cctype> a pour signature int std::toupper(int c). La fonction renvoie la majuscule correspondante selon la locale C actuelle, ou l’argument inchangé si aucune conversion n’est possible. Elle ne modifie pas l’argument : affectez le résultat à une variable ou utilisez-le autrement.
La valeur passée au paramètre de type int doit être égale à EOF ou être représentable par unsigned char. Toute autre valeur entraîne un comportement indéfini. Comme un char ordinaire peut être négatif, utilisez std::toupper(static_cast<unsigned char>(ch)) pour une variable de type char, à condition que la valeur obtenue après le cast soit représentable par int. Si int ne peut pas représenter toutes les valeurs de unsigned char, vérifiez avant l’appel que la valeur obtenue est représentable par int. Sinon, la conversion en int peut produire une valeur négative différente de EOF, ce qui entraîne un comportement indéfini. Si elle produit EOF, la fonction reçoit EOF au lieu de la valeur du caractère. Lorsqu’une fonction d’entrée renvoie un int, vérifiez si cette valeur vaut EOF avant de la convertir en unsigned char.
L’exemple traite une chaîne caractère par caractère et convertit explicitement le résultat de type int en char. Il suppose que chaque valeur obtenue après conversion en unsigned char est représentable par int. Avec la locale initiale "C", la sortie attendue est HELLO, C++23!, suivi d’un saut de ligne. Il ne s’agit pas d’un mécanisme général de conversion de casse Unicode : traiter ainsi les octets UTF-8 ne suffit pas.
Ne confondez pas cette fonction avec la surcharge std::toupper(c, loc) de <locale>, qui utilise un objet de locale fourni explicitement. Les indications ci-dessus sur la conversion en unsigned char s’appliquent à la fonction à un argument de <cctype>.
Exemples
#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';
}
Résultat
HELLO, C++23!
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.