当前位置： C语言 -- 附录 -- strcpy_s

strcpy_s函数

概要：

#define __STDC_WANT_LIB_EXT1__ 1
#include <string.h>
errno_t strcpy_s(char * restrict s1,
      rsize_t s1max,
      const char * restrict s2);

描述：

该函数将参数s2指向的字符串(包括终止空字符。)复制到参数s1指向的数组。

strcpy_s函数返回时，参数s1指向的、大小为s1max个字符的数组中strcpy_s函数写入的终止空字符（如果存在。）之后的所有元素值都是未指定的。这允许实现在将字符从s2复制到s1的同时，检查这些字符是否存在空字符。这种方式可能在发现第一个元素设置为空字符前，已向s1的每个元素都写入了一个字符。

运行约束：

参数s1和参数s2不是空指针。参数s1max应不大于宏RSIZE_MAX，且不等于0，且大于strnlen_s(s2, s1max)。复制不能发生在重叠对象之间。

在存在运行约束违规的情况下，如果参数s1不是空指针，参数s1max大于0且不大于宏RSIZE_MAX，函数将s1[0]设置为空字符。

参数：

char * restrict s1

指向目标数组的指针，复制的内容将存入该数组。

rsize_t s1max

目标数组中修改的最大字符数。

const char * restrict s2

指向源字符串的指针。

返回值：

如果不存在运行约束违规，函数返回0；否则函数返回非0值。

函数返回0意味着：从参数s2指向字符串中请求的所有字符都完整存入了参数s1指向的数组中，并且参数s1指向数组中的结果以空字符终止。

范例：

/*安全函数strcpy_s范例*/

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <string.h>

#define LENGTH 100

int main(void)
{
    const char source[] = "Time is money.";
    char destination[LENGTH];
    
    if(!(strcpy_s(destination, LENGTH, source)))
        puts(destination);
    
    return 0;
}

输出：

Time is money.

（注：使用Visual Studio编译。）

strcpy	复制字符串的函数。
memmove_s	移动内存区域字符序列的安全函数。
memcpy_s	复制内存区域字符序列的安全函数。
strncpy_s	从字符串中复制限定数量字符的安全函数。