std:: isupper

指定された文字が、現在インストールされているCロケールで分類される大文字であるかどうかをチェックします。デフォルトの "C" ロケールでは、 std::isupper は大文字（ ABCDEFGHIJKLMNOPQRSTUVWXYZ ）に対してのみ非ゼロの値を返します。

std::isupper が非ゼロの値を返す場合、同じCロケールにおいて同じ文字に対して std::iscntrl 、 std::isdigit 、 std::ispunct 、および std::isspace がゼロを返すことが保証されます。

ch の値が unsigned char として表現不可能であり、かつ EOF と等しくない場合、動作は未定義です。

パラメータ

戻り値

文字が大文字の場合、非ゼロの値。それ以外の場合、ゼロ。

注記

<cctype> の他のすべての関数と同様に、 std::isupper の動作は、引数の値が unsigned char として表現可能でなく、かつ EOF と等しくない場合、未定義です。これらの関数をプレーンな char （または signed char ）で安全に使用するには、引数をまず unsigned char に変換する必要があります：

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

同様に、イテレータの値型が char または signed char の場合、標準アルゴリズムで直接使用すべきではありません。代わりに、値を最初に unsigned char に変換してください：

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

例

#include <cctype>
#include <clocale>
#include <iostream>
int main()
{
    unsigned char c = '\xc6'; // ISO-8859-1における文字 Æ
    std::cout << "isupper(\'\\xc6\', default C locale) returned "
              << std::boolalpha << (bool)std::isupper(c) << '\n';
    std::setlocale(LC_ALL, "en_GB.iso88591");
    std::cout << "isupper(\'\\xc6\', ISO-8859-1 locale) returned "
              << std::boolalpha << (bool)std::isupper(c) << '\n';
}

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

関連項目