_mbccpy_s、_mbccpy_s_l

项目
06/09/2015

从一个字符串到另一个字符串复制多个字符。 _mbccpy、_mbccpy_l 的这些版本如 CRT 中的安全功能所述，其安全得到了增强。

重要

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

errno_t _mbccpy_s(
   unsigned char *dest,
   size_t buffSizeInBytes,
   int * pCopied,
   const unsigned char *src 
);
errno_t _mbccpy_s_l(
   unsigned char *dest,
   size_t buffSizeInBytes,
   int * pCopied,
   const unsigned char *src,
   locale_t locale
);
template <size_t size>
errno_t _mbccpy_s(
   unsigned char (&dest)[size],
   int * pCopied,
   const unsigned char *src 
); // C++ only
template <size_t size>
errno_t _mbccpy_s_l(
   unsigned char (&dest)[size],
   int * pCopied,
   const unsigned char *src,
   locale_t locale
); // C++ only

参数

[out] dest
复制目标。
[in] buffSizeInBytes
目标缓冲区的大小。
[out] pCopied
用复制的字节数填充 (1 或 2，如果成功)。如果您对该数字不关心，请传递NULL。
[in] src
要复制的多字节字符。
[in] locale
要使用的区域设置。

返回值

如果成功，则为零；如果失败，则为错误代码。如果 src 或 dest 是 NULL，或者，如果超过buffSizeinBytes字节都复制到 dest，则调用无效参数处理程序，如参数验证所述。如果允许执行继续，则这些函数将返回 errno 并将 EINVAL设置为EINVAL。

备注

_mbccpy_s 函数从src复制多字符到 dest 如果 src 不指向多字节字符的前导字节,就如同隐式调用 _ismbblead，则复制指向src 的单字节。如果 src 指向前导字节，但以下一个字节是 0 而无效，则将 0 复制到 dest，errno 设置为 EILSEQ，且函数返回 EILSEQ。

_mbccpy_s 不追加 null 结束符；但是，如果 src 指向空字符，则空字符被复制到 dest (为普通单字节复制)。

pCopied 的值用复制的字节数填充。 ;如果操作成功，可能的值为 1 和 2。如果传递 NULL，此参数将被忽略。

src	复制到 dest	pCopied	返回值
非前导字节	非前导字节	1	0
0	0	1	0
紧随非 0 的前导字节	紧随非 0 的前导字节	2	0
紧随 0 的前导字节	0	1	EILSEQ

注意第二行是第一行的一个特例。另外请注意，表格假定buffSizeInBytes > = pCopied。

_mbccpy_s 对与区域设置相关的所有行为使用当前区域设置。 _mbccpy_s_l 与 _mbccpy_s相同，但_mbccpy_s_l使用区域设置传递任何的区域相关行为。

在 C++ 中，使用这些函数是由重载模板简化；该重载可以自动推断缓冲区长度，而无需指定范围参数。有关详细信息，请参阅安全模板重载。

一般文本例程映射

Tchar.h 例程	未定义 _UNICODE 和 _MBCS	已定义 _MBCS	已定义 _UNICODE
_tccpy_s	映射到宏或内联函数。	_mbccpy_s	映射到宏或内联函数。

要求

例程	必需的标头
_mbccpy_s	<mbstring.h>
_mbccpy_s_l	<mbstring.h>

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

请参见

参考

区域设置

多字节字符序列的解释

_mbclen、mblen、_mblen_l

通过

_mbccpy_s、_mbccpy_s_l

参数

返回值

备注

要求

请参见

参考

其他资源