名前空間
変種
操作

std::tolower

提供: cppreference.com
< cpp‎ | string‎ | byte
ヘッダ <cctype> で定義
int tolower( int ch );

現在設定されている C のロケールによって定義されている文字変換ルールに従って、指定された文字を小文字に変換します。

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

目次

[編集] 引数

ch - 変換する文字。 ch の値が unsigned char で表現できず、 EOF とも等しくない場合、動作は未定義です

[編集] 戻り値

ch の小文字バージョン、または現在の C のロケールに小文字のバージョンがない場合は無変更の ch

[編集] ノート

<cctype> の他のすべての関数と同様に、引数の値が unsigned char で表現できず、 EOF とも等しくない場合、 std::tolower の動作は未定義です。 プレーンな 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)         // wrong
                // [](int c){ return std::tolower(c); }           // wrong
                // [](char c){ return std::tolower(c); }          // wrong
                   [](unsigned char c){ return std::tolower(c); } // correct
                  );
    return s;
}

[編集]

#include <iostream>
#include <cctype>
#include <clocale>
 
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


[編集] 関連項目

文字を大文字に変換します
(関数) [edit]
指定されたロケールの ctype ファセットを使用して文字を小文字に変換します
(関数テンプレート) [edit]
ワイド文字を小文字に変換します
(関数) [edit]