_mbsnbcat、_mbsnbcat_l

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

別のに、最大で、1 種類のマルチバイト文字列の n の先頭バイトを追加します。これらの関数のセキュリティを強化したバージョンについては、「_mbsnbcat_s、_mbsnbcat_s_l」を参照してください。

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

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

パラメーター

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

戻り値

_mbsnbcat は、コピー先文字列へのポインターを返します。エラーを示す戻り値は予約されていません。

解説

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

出力値は、ロケールの LC_CTYPE カテゴリの設定で決まります。詳細については、「setlocale」を参照してください。関数の _mbsnbcat のバージョンは、このロケールに依存する動作に現在のロケールを使用します; _mbsnbcat_l のバージョンは同じですが、これらは代わりに渡されたロケールパラメーターを使用します。詳細については、「ロケール」を参照してください。

Security Note の使用、null で終わる文字列。null で終わる文字列はコピー先のバッファーのサイズを超えることはできません。詳細については、「Avoiding Buffer Overruns」を参照してください。

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

C++ では、これらの関数にテンプレートのオーバーロードがあります。このオーバーロードは、これらの関数に対応するセキュリティで保護された新しい関数を呼び出します。詳細については、「セキュリティ保護されたテンプレートオーバーロード」を参照してください。

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

Tchar.h のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tcsncat	[strncat]	_mbsnbcat	wcsncat
_tcsncat_l	_strncat_l	_mbsnbcat_l	_wcsncat_l

必要条件

ルーチン	必須ヘッダー
_mbsnbcat	<mbstring.h>
_mbsnbcat_l	<mbstring.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

同等の .NET Framework 関数

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

次の方法で共有

_mbsnbcat、_mbsnbcat_l

パラメーター

戻り値

解説

必要条件

同等の .NET Framework 関数

参照

関連項目

その他のリソース