std::strxfrm
来自 cppreference.cn
| 定义于头文件 <cstring> |
||
| std::size_t strxfrm( char* dest, const char* src, std::size_t count ); |
||
将 src 所指向的空终止字节字符串转换为实现定义的格式，使得使用 std::strcmp 比较两个转换后的字符串与使用 std::strcoll 比较原始字符串得到相同的结果（在当前 C 本地环境）。
转换后字符串的前 count 个字符被写入到目标位置，包括终止空字符，并返回完整转换后字符串的长度，不包括终止空字符。
如果 dest 数组不够大，则行为未定义。如果 dest 和 src 重叠，则行为未定义。
如果 count 为 0，则允许 dest 为空指针。
内容 |
[编辑] 注解
可以接收完整转换后字符串的缓冲区的正确长度是 1 + std::strxfrm(nullptr, src, 0)。
当使用相同的字符串或字符串集进行多次依赖于区域设置的比较时，可以使用此函数，因为先使用 std::strxfrm 转换所有字符串一次，然后使用 std::strcmp 比较转换后的字符串会更有效率。
[编辑] 参数
| dest | - | 指向将写入转换后字符串的数组的首元素的指针 |
| src | - | 指向要转换的空终止字节字符串的首字符的指针 |
| count | - | 要写入的最大字符数 |
[编辑] 返回值
转换后字符串的长度，不包括终止空字符。
[编辑] 示例
运行此代码
#include <cassert> #include <cstring> #include <iomanip> #include <iostream> #include <string> int main() { char* loc = std::setlocale(LC_COLLATE, "cs_CZ.iso88592"); assert(loc); std::string in1 = "hrnec"; std::string out1(1 + std::strxfrm(nullptr, in1.c_str(), 0), ' '); std::string in2 = "chrt"; std::string out2(1 + std::strxfrm(nullptr, in2.c_str(), 0), ' '); std::strxfrm(&out1[0], in1.c_str(), out1.size()); std::strxfrm(&out2[0], in2.c_str(), out2.size()); std::cout << "In the Czech locale: "; if (out1 < out2) std::cout << in1 << " before " << in2 << '\n'; else std::cout << in2 << " before " << in1 << '\n'; std::cout << "In lexicographical comparison: "; if (in1 < in2) std::cout << in1 << " before " << in2 << '\n'; else std::cout << in2 << " before " << in1 << '\n'; }
可能的输出
In the Czech locale: hrnec before chrt In lexicographical comparison: chrt before hrnec
[编辑] 参见
转换宽字符串，使得 wcscmp 将产生与 wcscoll 相同的结果(函数) | |
| [虚函数] |
转换字符串，以便排序规则可以被比较替换 ( std::collate<CharT> 的虚保护成员函数) |
| 根据当前区域设置比较两个字符串 (函数) | |
| C 文档 关于 strxfrm
| |
