strxfrm：转换字符串

概要

#include <string.h>
size_t strxfrm(char *s1, const char *s2, size_t n);
```### 描述

此函数转换由 s2 指向的字符串，并将生成的字符串放入由 s1 指向的数组中。该转换的方式为：如果将 strcmp 函数应用于两个转换后的字符串，它将返回大于、等于或小于零的值，对应于将 strcoll 函数应用于相同的两个原始字符串的结果。

放入由 s1 指向的生成数组中的字符不超过 n 个，包括终止空字符。如果 n 为零，则 s1 可以是空指针。如果在重叠的对象之间进行复制，则行为是未定义的。

在 C 语言环境中，此函数仅执行复制操作。### 返回值

strxfrm 函数返回转换后的字符串的长度（不包括终止空字符）。如果返回的值大于或等于 n，则由 s1 指向的数组的内容是不确定的。

---

**权威来源**: BUSMASTER DITA help source `strxfrm.dita`, compiled into `BUSMASTER.CHM` with the application.