std::strxfrm
来自cppreference.com
<tbody>
</tbody>
| 在标头 <cstring> 定义
|
||
std::size_t strxfrm( char* dest, const char* src, std::size_t count ); |
||
变换 src 所指向的空终止字节字符串为实现定义形式，满足当前 C 本地环境中，以 std::strcmp 比较二个变换后字符串给出与用 std::strcoll 比较源字符串相同的结果。
将变换后字符串的前 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 << "在捷克本地环境中: ";
if(out1 < out2)
std::cout << in1 << " 先于 " << in2 << '\n';
else
std::cout << in2 << " 先于 " << in1 << '\n';
std::cout << "在字典序比较中: ";
if(in1 < in2)
std::cout << in1 << " 先于 " << in2 << '\n';
else
std::cout << in2 << " 先于 " << in1 << '\n';
}
可能的输出：
在捷克本地环境中: hrnec 先于 chrt
在字典序比较中: chrt 先于 hrnec
参阅
变换宽字符串，使得 wcscmp 会产生与 wsccoll 相同的结果 (函数) | |
[虚] |
变换字符串，使得能用比较替换校排 ( std::collate<CharT> 的虚受保护成员函数)
|
| 按照当前本地环境比较两个字符串 (函数) | |
strxfrm 的 C 文档
| |