memcpy_s 参数问题

memcpy_s 这个函数极易用错。它的函数申明是这样的：

errno_t memcpy_s(   void *dest,   size_t numberOfElements,   const void *src,   size_t count );

这是由 MS 提供的一个内存拷贝函数。对于各个参数的解释是这样的：

dest

New buffer.

numberOfElements

Size of the destination buffer.

src

Buffer to copy from.

count

Number of characters to copy.

numberOfElements ，如果我想拷贝一个 wchar_t 数组，那么这个 numberOfElements 指的是要拷贝的 wchar_t 个数吗 ？

count, 后面的英文解释简直是神来之笔，要拷贝的字符数。这不是坑人吗，字符有几种，有 char 的，有 wchar_t 的，占用的字节数不一样，如果要拷贝 

wchar_t 数组，那这个参数到底应该设置什么呢？

再者，光看这两个参数的名字，numberOfElements, count 有一定 c/c++ 编程经验的人，一定会觉得这两个参数的意图是想指，缓冲区的 element 个数(当我要拷贝 int 数组时，这里应该写 int 的个数吗?)和要拷贝的字符的个数。完全是什么跟什么。。。。。。

如果这样申明是不是好多了呢？

errno_t memcpy_s(   void *dest,   size_t bytesOfDist,   const void *src,   size_t bitesToCopy );

这样不是一目了然吗？

事实上，我能想到的，MS 应该也想到了，为什么这样申明呢，是因为这一系列函数还有：

errno_t memcpy_s(   void *dest,   size_t numberOfElements,   const void *src,   size_t count );errno_t wmemcpy_s(   wchar_t *dest,   size_t numberOfElements,   const wchar_t *src,   size_t count);

为了使用同样的参数名及参数解析，所以做了这样的权衡。

当要执行宽字节/双字节内存拷贝时，就应该使用 w_ 函数。在这个场景下， numberOfElements 指的就是 dist 双字节的个数，count 指的就是要拷贝的双字节个数。此时，它把双字节看作一个整体。

第一个函数中，把单字节看作一个整体。

所以，这两个函数在单字节内存模型和双字节内存模型下，实现了同样一种语义：拷贝(双)字节。各参数指的就是在各自的模型下，(双)字节的个数。

同样的，还有 memset 这个函数

void *memset(   void *dest,   int c,   size_t count );wchar_t *wmemset(   wchar_t *dest,   wchar_t c,   size_t count);