_mbsnbcpy_s、_mbsnbcpy_s_l

 

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

System_CAPS_important重要事项

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

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

System_CAPS_note注意

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

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

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

一般文本例程映射

Tchar.h 例程

未定义 _UNICODE 和 _MBCS

已定义 _MBCS

已定义 _UNICODE

_tcsncpy_s

_strncpy_s

_mbsnbcpy_s

_wcsncpy_s

_tcsncpy_s_l

_strncpy_s_l

_mbsnbcpy_s_l

_wcsncpy_s_l

要求

例程

必需的标头

_mbsnbcpy_s

<mbstring.h>

_mbsnbcpy_s_l

<mbstring.h>

有关兼容性的更多信息,请参见兼容性

.NET Framework 等效项

不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见平台调用示例

请参阅