_mbsnbcat_s、_mbsnbcat_s_l

[アーティクル]
03/26/2013

マルチバイト文字列に、最大で、別のマルチバイト文字列の n の先頭バイト追加します。これらは CRT のセキュリティ機能に説明されているように、のセキュリティが強化がある _mbsnbcat、_mbsnbcat_l のバージョンです。

重要
この API は Windows ランタイムで実行されるアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。

errno_t _mbsnbcat_s(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count 
);
errno_t _mbsnbcat_s_l(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbcat_s(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbcat_s_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

パラメーター

dest
NULL で終わるマルチバイト文字の文字列。
sizeInBytes
バイト dest バッファーのサイズ。
src
NULL で終わる関数の元の文字列。
Count
destに追加する src からのバイト数。
locale
使用するロケール。

戻り値

正常終了した場合はゼロ; それ以外の場合はエラーコード。

エラー条件

Dest	sizeInBytes	src	戻り値
NULL	任意	任意	EINVAL
どれでも可	0 以下	任意	EINVAL
どれでも可	任意	NULL	EINVAL

エラー条件のいずれかが実行されると、関数はパラメーターの検証に説明されているように、無効なパラメーターエラーが生成されます。エラーが処理されたとき、EINVAL 関数はを返し、EINVALに errno を設定します。

解説

_mbsnbcat_s 関数は destに、最大で、srcの count の先頭バイト追加します。すぐに dest の null 文字が前のバイトが先行バイトの場合、srcの先頭バイトで上書きされます。それ以外 src の最初のバイトは destの終端の null 文字を上書きします。count のバイトが追加される前に null バイトが src に表示された場合は、_mbsnbcat_s は null 文字まで src内のすべてのバイトを追加します。count が srcの長さを超える場合、src の長さは countの代わりに使用されます。文字列は、null 文字で終了します。重なり合う文字列間でコピーした場合の動作は未定義です。

出力値は、LC_CTYPE ロケールのカテゴリの設定で決まります。; 詳細については、setlocale、_wsetlocale を参照してください。これらの関数の各バージョンは同じただし、_l のサフィックスの使用が _l のサフィックスを渡されたロケールパラメーターを使用する代わりに、物と現在のロケールないものです。詳細については、「ロケール」を参照してください。

C++ では、これらの関数の使用はテンプレートオーバーロードによって簡素化されています; はオーバーロードでは、バッファー長を自動的に推論し、サイズ引数を指定する必要がなく自動的にセキュリティが弱い古い関数を置き換えるために、新しくセキュリティが強化された関数を使用できます。詳細については、「セキュリティ保護されたテンプレートオーバーロード」を参照してください。

これらの関数のデバッグバージョンは、最初にバッファーを 0xFD で埋めます。この動作を無効にするには、_CrtSetDebugFillThreshold を使用します。

汎用テキストルーチンのマップ

Tchar.h のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tcsncat	[strncat]	_mbsnbcat_s	wcsncat
_tcsncat_s_l	_strncat_s_l	_mbsnbcat_s_l	_wcsncat_s_l

必要条件

ルーチン	必須ヘッダー
_mbsnbcat_s	<mbstring.h>
_mbsnbcat_s_l	<mbstring.h>

互換性の詳細については、互換性を参照してください。

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

次の方法で共有

_mbsnbcat_s、_mbsnbcat_s_l

パラメーター

戻り値

解説

必要条件

同等の .NET Framework 関数

参照

関連項目

その他のリソース