_mbccpy，_mbccpy_l

将多字节字符从一个字符串复制到另一个字符串。 提供这些函数的更安全版本；请参阅 _mbccpy_s、_mbccpy_s_l。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。 有关详细信息，请参阅通用 Windows 平台应用中不支持的 CRT 函数。

语法

void _mbccpy(
   unsigned char *dest,
   const unsigned char *src
);
void _mbccpy_l(
   unsigned char *dest,
   const unsigned char *src,
   _locale_t locale
);

参数

dest
复制目标。

src
要复制的多字节字符。

locale
要使用的区域设置。

备注

_mbccpy 函数将一个多字节字符从 src 复制到 dest。

此函数验证其参数。 如果 _mbccpy 为 dest 或 src 传递了空指针，则会调用无效参数处理程序，如参数验证中所述。 如果允许执行继续，则 errno 将设置为 EINVAL。

_mbccpy 对依赖于区域设置的任何行为使用当前区域设置。 _mbccpy_l 等同于 _mbccpy，只不过 _mbccpy_l 使用为所有与区域设置相关的行为传入的区域设置。 有关详细信息，请参阅 Locale。

安全说明 使用以 null 结尾的字符串。 以 null 结尾的字符串不得超过目标缓冲区的大小。 有关详细信息，请参阅避免缓冲区溢出。 缓冲区溢出问题是常见的系统攻击方法，使权限的提升不能确保。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

Tchar.h 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_tccpy	映射到宏或内联函数	_mbccpy	映射到宏或内联函数
_tccpy_l	不适用	_mbccpy_l	不适用

要求

例程	必需的标头
_mbccpy	<mbctype.h>
_mbccpy_l	<mbctype.h>

有关兼容性的详细信息，请参阅 兼容性。

另请参阅

区域设置
多字节字符序列的解释
_mbclen、mblen、_mblen_l