_mbsnbcat、_mbsnbcat_l

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

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 バイトが追加される前に src に null バイトがあった場合は、_mbsnbcat は null 文字までの src 内のすべてのバイトを追加します。 count が src の長さを超えている場合は、src の長さが count の代わりに使用されます。結果の文字列は null 文字で終了します。重なり合う文字列間でコピーした場合の動作は未定義です。

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

セキュリティに関するメモ 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>

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

同等の .NET Framework 関数

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

次の方法で共有

_mbsnbcat、_mbsnbcat_l

パラメーター

戻り値

解説

必要条件

同等の .NET Framework 関数

参照

関連項目

その他のリソース