_mbsnbcat_s、_mbsnbcat_s_l

[アーティクル]
06/09/2015

マルチバイト文字列に最大で別のマルチバイト文字の 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 関数

参照

関連項目

その他のリソース