std::strxfrm
定义于头文件 <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(NULL, src, 0) 。
在以同一字符串或字符串集合进行多个本地环境依赖的比较时,使用此函数,因为仅用 std::strxfrm
变换所有字符串一次,而以 std::strcmp 进行后继比较更为高效。
参数
dest | - | 指向将写入变换后的字符串的数组首元素的指针 |
src | - | 指向要变换的空终止字节字符串首元素的指针 |
count | - | 要写入的最大字符数 |
返回值
变换后的字符串长度,不包含空终止字符。
示例
运行此代码
#include <iostream> #include <iomanip> #include <cstring> #include <string> #include <cassert> 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 会产生与 wsccoll 相同的结果 (函数) | |
[虚] |
变换字符串,使得能用比较替换对照 ( std::collate<CharT> 的虚受保护成员函数) |
按照当前本地环境比较两个字符串 (函数) |