strxfrm

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

字符串库

空终止字节字符串

空终止多字节字符串

空终止宽字符串

 

空终止字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
与数字格式相互转换
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
字符串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字符串检查
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
内存操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
杂项
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

定义于头文件 <string.h>
size_t strxfrm( char          *dest, const char          *src, size_t count );		(直到 C99)
size_t strxfrm( char *restrict dest, const char *restrict src, size_t count );		(C99 起)

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

转换后的字符串的前 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

参考

• C17 标准 (ISO/IEC 9899:2018)

• 7.24.4.5 strxfrm 函数 (p: 267)

• C11 标准 (ISO/IEC 9899:2011)

• 7.24.4.5 strxfrm 函数 (p: 366-367)

• C99 标准 (ISO/IEC 9899:1999)

• 7.21.4.5 strxfrm 函数 (p: 329-330)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 4.11.4.5 strxfrm 函数

另请参阅

strcoll	根据当前区域设置比较两个字符串 (函数)
wcscoll (C95)	根据当前语言环境比较两个宽字符串 (函数)
strcmp	比较两个字符串 (函数)
wcsxfrm (C95)	转换宽字符串，使 wcscmp 产生与 wcscoll 相同的结果 (函数)
C++ 文档 关于 strxfrm