Namespaces
Variants

std::ctype<CharT>:: tolower, std::ctype<CharT>:: do_tolower

From cppreference.net
定义于头文件 <locale>
public :
CharT tolower ( CharT c ) const ;
(1)
public :
const CharT * tolower ( CharT * beg, const CharT * end ) const ;
(2)
protected :
virtual CharT do_tolower ( CharT c ) const ;
(3)
protected :
virtual const CharT * do_tolower ( CharT * beg, const CharT * end ) const ;
(4)
1,2) 公共成员函数,调用最派生类的受保护虚成员函数 do_tolower
3) 如果此区域设置定义了小写形式,则将字符 c 转换为小写。
4) 对于字符数组 [ beg , end ) 中的每个字符,若存在对应的小写形式,则将该字符替换为其小写形式。

目录

参数

c - 要转换的字符
beg - 指向要转换字符数组中首个字符的指针
end - 指向要转换字符数组末尾后一位置的指针

返回值

1,3) 小写字符,若该区域设置未列出小写形式则为 c
2,4) end

注释

该函数仅能执行1:1字符映射,例如希腊大写字母'Σ'根据在单词中的位置有两种小写形式:'σ'和'ς'。在此情况下无法通过调用 do_tolower 获得正确的小写形式。

示例

#include <iostream>
#include <locale>
void try_lower(const std::ctype<wchar_t>& f, wchar_t c)
{
    wchar_t up = f.tolower(c);
    if (up != c)
        std::wcout << "Lower case form of \'" << c << "' is " << up << '\n';
    else
        std::wcout << '\'' << c << "' has no lower case form\n";
}
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    std::wcout.imbue(std::locale());
    std::wcout << "In US English UTF-8 locale:\n";
    auto& f = std::use_facet<std::ctype<wchar_t>>(std::locale());
    try_lower(f, L'Σ');
    try_lower(f, L'Ɛ');
    try_lower(f, L'A');
    std::wstring str = L"HELLo, wORLD!";
    std::wcout << "Lowercase form of the string '" << str << "' is ";
    f.tolower(&str[0], &str[0] + str.size());
    std::wcout << '\'' << str << "'\n";
}

输出:

In US English UTF-8 locale:
Lower case form of 'Σ' is σ
Lower case form of 'Ɛ' is ɛ
Lower case form of 'A' is a
Lowercase form of the string 'HELLo, wORLD!' is 'hello, world!'

参见

调用 do_toupper
(公开成员函数)
将字符转换为小写
(函数)
将宽字符转换为小写
(函数)