std::strxfrm

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

字符串库

空终止字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

空终止字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
转换到数值格式
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
字符串操作
strcpy
strncpy
strcat
strncat
strxfrm
字符串检验
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
内存操作
memchr
memcmp
memset
memcpy
memmove
杂项
strerror

 

定义于头文件 <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

参阅

wcsxfrm	变换宽字符串，使得 wcscmp 会产生与 wsccoll 相同的结果 (函数)
do_transform [虚]	变换字符串，使得能用比较替换对照 (std::collate<CharT> 的虚受保护成员函数)
strcoll	按照当前本地环境比较两个字符串 (函数)