C语言 memcpy_s 函数-猿说编程

零基础 C/C++ 学习路线推荐 : C/C++ 学习目录 >> C 语言基础入门

一.memcpy_s函数简介

C 语言在 string.h 中 memcpy 函数,可用完成 char 字符串拷贝；而今天即将介绍的 memcpy_s 函数其实和 memcpy 函数类似, memcpy 函数使用时，我们也注意到了两个问题：

1.memcpy函数报错：error C4996

error C4996: 'memcpy': This function or variable may be unsafe. Consider using memcpy_s instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. See online help for details.

解决办法：include 之后添加代码
#pragma warning( disable : 4996)

2.memcpy函数没有方法来保证有效的缓冲区尺寸，使用不安全

memcpy 函数没有方法来保证有效的缓冲区尺寸，所以它仅仅能假定缓冲足够大来容纳要拷贝的字符串。在程序执行时，这将导致不可预料的行为，容易导致程序崩溃，例如如下代码：

/******************************************************************************************/
//@Author:猿说编程
//@Blog(个人博客地址): www.codersrc.com
//@File:C语言教程 - C语言 memcpy_s 函数
//@Time:2021/06/03 08:00
//@Motto:不积跬步无以至千里，不积小流无以成江海，程序人生的精彩需要坚持不懈地积累！
/******************************************************************************************/   

char src[1024] = { "C/C++教程-memcpy函数\0 - www.codersrc.com" };
char dst[10] = { 0 };
int len_src = sizeof(src)/sizeof(char); // 1024
int len_dst = sizeof(dst) / sizeof(char); //10 
printf("len_src:%d len_dst:%d\n", len_src,len_dst);
printf("memcpy之前 dst:%s\n", dst);
memcpy(dst, src , len_src);  // 很明显 dst 的空间大小并不能完全存放 src,程序结束时会崩溃
printf("memcpy之后 dst:%s\n", dst);

二.memcpy_s函数语法

memcpy_s函数可以通过设置目标缓冲区大小来够避免上面的不可预料的行为，语法如下：

/*
*描述：此类函数是用于对字符串进行复制（拷贝）。
*
*参数： 
*   [out] strDestination：拷贝完成之后的字符串
*   [in] numberOfElements： strDestination目标缓冲区长度
*   [in] strSource：需要拷贝的字符串
*   [in] count：需要拷贝的字符串长度
*
*返回值：返回一个整数，0表示复制成功，返回非0值代表复制不成功，不同的值表示不同的错误，具体内容可以查阅MSDN手册
*注意：numberOfElenments必须大于等于count，否则拷贝将出现中断。
*/
errno_t memcpy_s(char *strDestination , size_t numberOfElements , const char *strSource ， size_t count);

三.memcpy_s函数实战

/******************************************************************************************/
//@Author:猿说编程
//@Blog(个人博客地址): www.codersrc.com
//@File:C语言教程 - C语言 memcpy_s 函数
//@Time:2021/06/03 08:00
//@Motto:不积跬步无以至千里，不积小流无以成江海，程序人生的精彩需要坚持不懈地积累！
/******************************************************************************************/ 

#include "stdafx.h"
#include<stdlib.h>
#include<stdio.h>
#include<string.h>
#include "windows.h"

//error C4996: 'memcpy': This function or variable may be unsafe. Consider using memcpy_s instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. See online help for details.
//#pragma warning( disable : 4996)

void main()
{
    char src[1024] = { "C/C++教程-memcpy_s函数 - www.codersrc.com" };
    char dst[1024] = { 0 };
    int len_src = sizeof(src)/sizeof(char);
    int len_dst = sizeof(dst) / sizeof(char);
    printf("len_src:%d len_dst:%d\n", len_src,len_dst);
    printf("memcpy_s之前 dst:%s\n", dst);
    memcpy_s(dst, sizeof(dst)/sizeof(dst[0]), src,sizeof(src)/sizeof(src[0])); 
    printf("memcpy_s之后 dst:%s\n", dst);
    printf("\n");
    system("pause");
}
/*
输出：
len_src:1024 len_dst:1024
memcpy_s之前 dst:
memcpy_s之后 dst:C/C++教程-memcpy_s函数 - www.codersrc.com
请按任意键继续. . .
*/

注意：memcpy_s 函数第二个参数，是设置目标缓冲区大小，并非原始缓冲区大小

memcpy_s(dst, sizeof(dst)/sizeof(dst[0]), src,sizeof(src)/sizeof(src[0]));  //正确写法
memcpy_s(dst, sizeof(src)/sizeof(src[0]), src,sizeof(src)/sizeof(src[0]));  //错误写法