函数模板
<locale>

std::tolower

template <class charT>  charT tolower (charT c, const locale& loc);
使用 locale 将大写字母转换为小写字母
如果 c 是一个大写字母并且有一个对应的小写字母,则将 c 转换为其小写等效项,转换方式由 locale 的 ctype 方面确定。如果无法进行此类转换,则返回的 c 不变。

此函数返回的结果与调用 ctype::tolower 相同,如

1
use_facet < ctype<charT> > (loc).tolower (c)

此函数模板重载了 C 函数 tolower(定义在 <cctype> 中)。

参数

c
要转换的字符。
loc
要使用的 locale。它必须具有 ctype 方面。

模板参数 charT 是字符类型。

返回值

c 对应的小写字符,如果存在的话。否则 c 不变。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
// tolower example (C++)
#include <iostream>       // std::cout
#include <string>         // std::string
#include <locale>         // std::locale, std::tolower

int main ()
{
  std::locale loc;
  std::string str="Test String.\n";
  for (std::string::size_type i=0; i<str.length(); ++i)
    std::cout << std::tolower(str[i],loc);
  return 0;
}

输出

test string.


数据竞争

将访问 loc 及其 ctype 方面。

异常安全

强保证:如果抛出异常,则没有效果。

另见