_mbccpy_s _mbccpy_s_l

發行項
03/27/2013

複製資料的單一多位元組字元到另一個字串。這些是 _mbccpy _mbccpy_l 的安全性增強版本，如安全性功能，則在 CRT 中中所述。

重要事項
這個 API 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 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，然後不正確的參數叫用處理常式，如參數驗證中所述。如果執行允許繼續執行，函式會傳回 EINVAL 和 errno 設定為 EINVAL。

備註

_mbccpy_s 函式複製 src 的多位元組字元加入至 dest。如果未指向多位元組字元的前導位元組 (如隱含呼叫 src 決定對 _ismbblead，則為 src 所複製的單一位元組。如果對前導位元組的 src 上，但以下位元組是 0 而不正確，則 0 複製到 dest， errno 設定為 EILSEQ函式會傳回 EILSEQ。

_mbccpy_s 不附加 null 結束字元;不過，則為，否則為 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>

如需更多關於相容性的資訊，請參閱入門介紹中的相容性 (Compatibility) 。

請參閱

參考

地區設定

多位元組字元序列的轉譯工作

_mbclen，mblen _mblen_l

共用方式為

_mbccpy_s _mbccpy_s_l

參數

傳回值

備註

需求

請參閱

參考

其他資源