strxfrm
来自cppreference.com
在标头 <string.h> 定义
|
||
(C99 前) | ||
(C99 起) | ||
变换 src
所指向的空终止字节字符串为实现定义形式,满足当前 C 本地环境中,以 strcmp 比较二个变换后字符串给出与用 strcoll 比较源字符串相同的结果。
将变换后字符串的首 count
个字符写入目标,包含空终止字符,并返回排除空终止字符的完整转换后字符串的长度。
若 dest
数组不够大则行为未定义。若 dest
与 src
重叠则行为未定义。
若 count
为 0,则允许 dest
为空指针。
注意
能接收整个变换后字符串的正确缓冲区长度为 1+strxfrm(NULL, src, 0)。
在以同一字符串或字符串集合进行多个本地环境依赖的比较时,使用此函数,因为仅用 strxfrm
变换所有字符串一次,而以 strcmp 进行后继比较更为高效。
参数
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 页)