strxfrm

将 src 所指向的空终止字节字符串转换为实现定义的形式，使得用 strcmp 比较两个转换后的字符串，与在当前 C 语言区域设置下用 strcoll 比较原始字符串的结果相同。

转换后的字符串前 count 个字符（包括终止空字符）将被写入目标位置，同时返回完整转换后字符串的长度（不包括终止空字符）。

若 dest 数组空间不足，则行为未定义。若 dest 与 src 存在内存重叠，则行为未定义。

如果 count 为 ​ 0 ​ ，则允许 dest 为空指针。

注释

接收整个转换后字符串的正确缓冲区长度是 1 + strxfrm ( NULL , src, 0 )

此函数在进行多次依赖于区域设置的字符串比较时使用，因为更高效的做法是使用 strxfrm 一次性转换所有字符串，随后通过 strcmp 比较转换后的字符串。

参数

返回值

转换后字符串的长度，不包括终止空字符。

示例

#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

参考文献

参见