_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