std:: isupper

Vérifie si le caractère donné est un caractère majuscule tel que classifié par les paramètres régionaux C actuellement installés. Dans les paramètres régionaux par défaut "C" , std::isupper retourne une valeur non nulle uniquement pour les lettres majuscules ( ABCDEFGHIJKLMNOPQRSTUVWXYZ ).

Si std::isupper retourne une valeur non nulle, il est garanti que std::iscntrl , std::isdigit , std::ispunct , et std::isspace retournent zéro pour le même caractère dans la même locale C.

Le comportement n'est pas défini si la valeur de ch n'est pas représentable en tant que unsigned char et n'est pas égale à EOF .

Paramètres

Valeur de retour

Valeur non nulle si le caractère est une lettre majuscule, zéro sinon.

Notes

Comme toutes les autres fonctions de <cctype> , le comportement de std::isupper est indéfini si la valeur de l'argument n'est ni représentable comme unsigned char ni égale à EOF . Pour utiliser ces fonctions en toute sécurité avec des char simples (ou des signed char ), l'argument doit d'abord être converti en unsigned char :

bool my_isupper(char ch)
{
    return std::isupper(static_cast<unsigned char>(ch));
}

De même, ils ne doivent pas être utilisés directement avec des algorithmes standard lorsque le type de valeur de l'itérateur est char ou signed char . À la place, convertissez d'abord la valeur en unsigned char :

int count_uppers(const std::string& s)
{
    return std::count_if(s.begin(), s.end(),
                      // static_cast<int(*)(int)>(std::isupper)         // incorrect
                      // [](int c){ return std::isupper(c); }           // incorrect
                      // [](char c){ return std::isupper(c); }          // incorrect
                         [](unsigned char c){ return std::isupper(c); } // correct
                        );
}

Exemple

#include <cctype>
#include <clocale>
#include <iostream>
int main()
{
    unsigned char c = '\xc6'; // lettre Æ en ISO-8859-1
    std::cout << "isupper(\'\\xc6\', locale C par défaut) a retourné "
              << std::boolalpha << (bool)std::isupper(c) << '\n';
    std::setlocale(LC_ALL, "en_GB.iso88591");
    std::cout << "isupper(\'\\xc6\', locale ISO-8859-1) a retourné "
              << std::boolalpha << (bool)std::isupper(c) << '\n';
}

isupper('\xc6', default C locale) returned false
isupper('\xc6', ISO-8859-1 locale) returned true

Voir aussi