_mbsnbcat, _mbsnbcat_l

  • [アーティクル]

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

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない 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
src に追加される dest のバイト数。

locale
使用するロケール。

戻り値

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

解説

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

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

セキュリティに関するメモ null で終わる文字列を使用してください。 null で終わる文字列はターゲット バッファーのサイズを超えないようにしてください。 詳細については、「バッファー オーバーランの回避」を参照してください。

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

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

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

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

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>

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

関連項目

文字列操作
_mbsnbcmp, _mbsnbcmp_l
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l
_mbsnbcpy, _mbsnbcpy_l
_mbsnbicmp, _mbsnbicmp_l
_mbsnbset, _mbsnbset_l
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
_mbsnbcat_s, _mbsnbcat_s_l