_mbsnbcpy_s、_mbsnbcpy_s_l

项目
06/09/2015

复制字符串的 n 字节到目标字符串。 _mbsnbcpy、_mbsnbcpy_l 的这些版本如 CRT 中的安全功能所述，其安全得到了增强。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。有关详细信息，请参见 CRT functions not supported with /ZW（CRT 函数不支持使用/ZW）。

errno_t _mbsnbcpy_s(
   unsigned char * strDest,
   size_t sizeInBytes,
   const unsigned char * strSource,
   size_t count 
);
errno_t _mbsnbcpy_s_l(
   unsigned char * strDest,
   size_t sizeInBytes,
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbcpy_s(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbcpy_s_l(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
); // C++ only

参数

strDest
要复制的目标字符字符串。
sizeInBytes
目标缓冲区大小。
strSource
要复制的字符字符串。
count
要复制的字节数。
locale
要使用的区域设置。

返回值

如果成功，为零；如果传递一个错误的参数，则为EINVAL。

备注

_mbsnbcpy_s 函数复制 strSource 的 count 字节到 strDest。如果 count 超过 strDest的大小，或者输入字符串为 null 指针，或者 sizeInBytes 或 count 为 0，则函数调用参数无效处理程序，如参数验证所述。如果允许执行继续，则该函数返回EINVAL。如果源和目标字符串重叠，则 _mbsnbcpy_s 的行为未定义。

输出值受区域设置的 LC_CTYPE 类设置影响；有关更多信息，请参见 setlocale。这些不带 _l 后缀的函数的版本使用为该区域设置相关的行为的当前区域设置；带有 _l 后缀的版本相同，只不过它们使用传递的区域设置参数。有关详细信息，请参阅区域设置。

备注

不同于此函数的不安全版本，_mbsnbcpy_s 不执行任何空填充，并始终以 null 终止该字符串。

在 C++ 中，使用这些函数由模板重载简化；重载可以自动推导出缓冲区长度 (不再需要指定大小参数)，并且它们可以自动用以更新、更安全的对应物替换旧的、不安全的函数。有关详细信息，请参阅安全模板重载。

这些函数的调试版本首先用 0xFD 填充缓冲区。若要禁用此行为，请使用 _CrtSetDebugFillThreshold。

一般文本例程映射