C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- std::basic_string
- std::basic_string_view
- 空终止字节字符串
- std::isalnum
- std::isalpha
- std::islower
- std::isupper
- std::isdigit
- std::isxdigit
- std::isblank
- std::iscntrl
- std::isgraph
- std::isspace
- std::isprint
- std::ispunct
- std::tolower
- std::toupper
- std::atof
- std::atoi, std::atol, std::atoll
- std::strtol, std::strtoll
- std::strtoul, std::strtoull
- std::strtof, std::strtod, std::strtold
- std::strtoimax, std::strtoumax
- std::strcpy
- std::strncpy
- std::strcat
- std::strncat
- std::strxfrm
- std::strlen
- std::strcmp
- std::strncmp
- std::strcoll
- std::strchr
- std::strrchr
- std::strspn
- std::strcspn
- std::strpbrk
- std::strstr
- std::strtok
- std::memchr
- std::memcmp
- std::memset
- std::memcpy
- std::memmove
- std::strerror
- 空终止多字节字符串
- 空终止宽字符串
- std::char_traits
- 注释
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::tolower
定义于头文件 <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) // 错误 // [](int c){ return std::tolower(c); } // 错误 // [](char c){ return std::tolower(c); } // 错误 [](unsigned char c){ return std::tolower(c); } // 正确 ); return s; }
示例
运行此代码
#include <iostream> #include <cctype> #include <clocale> int main() { unsigned char c = '\xb4'; // ISO-8859-15 中的字符 Ž // 但在 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 刻面将字符转换为小写 (函数模板) | |
转换宽字符为小写 (函数) |