strxfrm
来自cppreference.com
| 在标头 <string.h> 定义
|
||
| (C99 前) | ||
| (C99 起) | ||
变换 src 所指向的空终止字节字符串为实现定义形式，满足当前 C 本地环境中，以 strcmp 比较二个变换后字符串给出与用 strcoll 比较源字符串相同的结果。
将变换后字符串的首 count 个字符写入目标，包含空终止字符，并返回排除空终止字符的完整转换后字符串的长度。
若 dest 数组不够大则行为未定义。若 dest 与 src 重叠则行为未定义。
若 count 为 0 ，则允许 dest 为空指针。
在以同一字符串或字符串集合进行多个本地环境依赖的比较时，使用此函数，因为仅用 strxfrm 变换所有字符串一次，而以 strcmp 进行后继比较更为高效。
注意
能接收整个变换后字符串的正确缓冲区长度为 1+strxfrm(NULL, src, 0) 。
参数
| dest | - | 指向将写入变换后的字符串的数组首元素的指针 |
| src | - | 指向要变换的空终止字节字符串首元素的指针 |
| count | - | 要写入的最大字符数 |
返回值
变换后的字符串长度，不包含空终止字符。
示例
运行此代码
#include <stdio.h> #include <string.h> #include <locale.h> int main(void) { setlocale(LC_COLLATE, "cs_CZ.iso88592"); const char *in1 = "hrnec"; char out1[1+strxfrm(NULL, in1, 0)]; strxfrm(out1, in1, sizeof out1); const char *in2 = "chrt"; char out2[1+strxfrm(NULL, in2, 0)]; strxfrm(out2, in2, sizeof out2); printf("In the Czech locale: "); if(strcmp(out1, out2) < 0) printf("%s before %s\n",in1, in2); else printf("%s before %s\n",in2, in1); printf("In lexicographical comparison: "); if(strcmp(in1, in2)<0) printf("%s before %s\n",in1, in2); else printf("%s before %s\n",in2, in1); }
输出：
In the Czech locale: hrnec before chrt In lexicographical comparison: chrt before hrnec
引用
- C11 标准（ISO/IEC 9899:2011）：
- 7.24.4.5 The strxfrm function （第 366-367 页）