_mbsnbcpy, _mbsnbcpy_l
复制字符串的 n 字节到目标字符串。 这些功能的更安全的版本可用参见 _mbsnbcpy_s, _mbsnbcpy_s_l。
重要
此 API 不能在 Windows 运行时执行的应用程序。有关更多信息,请参见 CRT 函数不支持与 /ZW。
unsigned char * _mbsnbcpy(
unsigned char * strDest,
const unsigned char * strSource,
size_t count
);
unsigned char * _mbsnbcpy_l(
unsigned char * strDest,
const unsigned char * strSource,
size_t count,
_locale_t locale
);
template <size_t size>
unsigned char * _mbsnbcpy(
unsigned char (&strDest)[size],
const unsigned char * strSource,
size_t count
); // C++ only
template <size_t size>
unsigned char * _mbsnbcpy_l(
unsigned char (&strDest)[size],
const unsigned char * strSource,
size_t count,
_locale_t locale
); // C++ only
参数
strDest
要复制的字符字符串的目标。strSource
要复制的字符字符串。count
要复制的字节数。locale
使用的区域设置。
返回值
_mbsnbcpy 返回指向目标字符字符串。 没有任何返回值保留指示错误。
备注
_mbsnbcpy 功能复制 strSource 的 count 字节到 strDest。 如果 count 超过 strDest 的大小或源和目标字符串重叠,_mbsnbcpy 行为不确定。
如果 strSource 或 strDest 是 null 指针,此函数调用的参数无效处理程序如 参数验证所述。 如果执行允许继续,该函数返回 NULL 并将 errno 到 EINVAL。
输出值受设置 LC_CTYPE 类设置的影响区域设置;请参见 setlocale, _wsetlocale 有关更多信息。 这些功能的版本是没有 _l 后缀使用当前区域设置和版本有 _l 后缀使用区域设置参数传递的相同,不同之处在于,这些。 有关更多信息,请参见区域设置。
安全说明 |
---|
这些功能可能容易受到的缓冲区溢出威胁。缓冲区溢出可用于执行任意攻击者代码,可能会导致权限未确保提升和削弱系统。有关更多信息,请参见 避免缓冲区溢出。 |
在 C++ 中,这些函数的调用这些功能较新的模板超负载,更安全的副本。 有关更多信息,请参见安全模板重载。
一般文本例程映射
Tchar.h 实例 |
未定义的_UNICODE 和_MBCS |
定义的_MBCS |
定义的_UNICODE |
---|---|---|---|
_tcsncpy |
_mbsnbcpy |
||
_tcsncpy_l |
_strncpy_l |
_mbsnbcp_l |
_wcsncpy_l |
要求
实例 |
必需的标头 |
---|---|
_mbsnbcpy |
<mbstring.h> |
_mbsnbcpy_l |
<mbstring.h> |
有关更多兼容性信息,请参见 兼容性。
.NET Framework 等效项
不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见平台调用示例。
请参见
参考
_strncnt、_wcsncnt、_mbsnbcnt、_mbsnbcnt_l、_mbsnccnt、_mbsnccnt_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l