Namespaces
Variants

std:: tolower

From cppreference.net
C++
Text processing library
Null-terminated byte strings
ヘッダーで定義 <cctype>
int tolower ( int ch ) ;

指定された文字を、現在インストールされているCロケールで定義された文字変換規則に従って小文字に変換します。

デフォルトの "C" ロケールでは、以下の大文字 ABCDEFGHIJKLMNOPQRSTUVWXYZ が対応する小文字 abcdefghijklmnopqrstuvwxyz に置換されます。

目次

パラメータ

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

戻り値

ch の小文字バージョン、または現在のCロケールに小文字バージョンがリストされていない場合は変更されていない ch 。

注記

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

char my_tolower(char ch)
{
    return static_cast<char>(std::tolower(static_cast<unsigned char>(ch)));
}

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

std::string str_tolower(std::string s)
{
    std::transform(s.begin(), s.end(), s.begin(),
                // static_cast<int(*)(int)>(std::tolower)         // 誤り
                // [](int c){ return std::tolower(c); }           // 誤り
                // [](char c){ return std::tolower(c); }          // 誤り
                   [](unsigned char c){ return std::tolower(c); } // 正しい
                  );
    return s;
}

例

このコードを実行 
#include <cctype>
#include <clocale>
#include <iostream>
int main()
{
    unsigned char c = '\xb4'; // the character Ž in ISO-8859-15
                              // but ´ (acute accent) in ISO-8859-1
    std::setlocale(LC_ALL, "en_US.iso88591");
    std::cout << std::hex << std::showbase;
    std::cout << "in iso8859-1, tolower('0xb4') gives " << std::tolower(c) << '\n';
    std::setlocale(LC_ALL, "en_US.iso885915");
    std::cout << "in iso8859-15, tolower('0xb4') gives " << std::tolower(c) << '\n';
}

出力例: 

in iso8859-1, tolower('0xb4') gives 0xb4
in iso8859-15, tolower('0xb4') gives 0xb8

関連項目

文字を大文字に変換する
(関数)
ロケールの ctype ファセットを使用して文字を小文字に変換する
(関数テンプレート)
ワイド文字を小文字に変換する
(関数)
Cドキュメント for tolower

外部リンク

1. ISO/IEC 8859-1 。ウィキペディアより。
2. ISO/IEC 8859-15 。ウィキペディアより。