1）将ch值（在转换为无符号字符后，就像通过（unsigned char）ch）复制到dest指向的对象的每个第一个计数字符中。

如果访问超出dest数组的末尾，则行为未定义。如果dest是空指针，行为是未定义的。

2）与（1）相同，只是在运行时检测到以下错误，并且如果dest和destsz本身有效，则在将ch存储到目标范围[dest，dest + destsz）的每个位置之后调用当前安装的约束处理函数：

• dest 是一个空指针

• destsz或count大于RSIZE_MAX

• count大于destsz（会发生缓冲区溢出）

如果由dest <count <= destsz指向的字符数组的大小，行为是未定义的; 换句话说，destsz的错误值不会暴露即将发生的缓冲区溢出。 作为所有边界检查函数，只有当__STDC_LIB_EXT1__由实现定义时，以及在包含string.h之前用户将__STDC_WANT_LIB_EXT1__定义为整数常量1时，memset_s才能保证可用。

参数

返回值

1） dest 副本

2）成功时为零，错误时为非零。 同样出错的是，如果dest不是空指针并且destsz有效，那么将destsz填充字节ch写入目标数组。

注意

如果此函数修改的对象在其余生命期内（例如，gcc bug 8537）不再被访问，则memset可能会被优化（在as-if规则下）。 因为这个原因，这个函数不能用来擦洗内存（例如，填充一个存储密码为零的数组）。 memset_s禁止这种优化：保证执行内存写入。 第三方解决方案包括FreeBSD explicit_bzero或Microsoft SecureZeroMemory。

例

#define __STDC_WANT_LIB_EXT1__ 1#include <stdio.h>#include <string.h>#include <stdlib.h>
 int main(void){
    char str[] = "ghghghghghghghghghghgh";    puts(str);    memset(str,'a',5);    puts(str);
 #ifdef __STDC_LIB_EXT1__    set_constraint_handler_s(ignore_handler_s);
    int r = memset_s(str, sizeof str, 'b', 5);    printf("str = \"%s\", r = %d\n", str, r);
    r = memset_s(str, 5, 'c', 10);   // count is greater than destsz      printf("str = \"%s\", r = %d\n", str, r);#endif}

可能的输出：

ghghghghghghghghghghgh
aaaaahghghghghghghghgh
str = "bbbbbhghghghghghghghgh", r = 0str = "ccccchghghghghghghghgh", r = 22

参考

• C11标准（ISO / IEC 9899：2011）：

• 7.24.6.1 memset函数（p：371）

• K.3.7.4.1 memset_s函数（p：621-622）

• C99标准（ISO / IEC 9899：1999）：

• 7.21.6.1 memset函数（p：333）

• C89 / C90标准（ISO / IEC 9899：1990）：

• 4.11.6.1 memset函数

扩展内容

| memset的C ++文档 |