_mbsnbcpy
, _mbsnbcpy_l
文字列の n バイトをコピー先の文字列にコピーします。 これらの関数のより安全なバージョンを使用できます。詳細については、_mbsnbcpy_s_l
以下を参照してください_mbsnbcpy_s
。
重要
この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。
構文
unsigned char * _mbsnbcpy(
unsigned char * strDest,
const unsigned char * strSource,
size_t count
);
unsigned char * _mbsnbcpy_l(
unsigned char * strDest,
const unsigned char * strSource,
size_t count,
_locale_t locale
);
template <size_t size>
unsigned char * _mbsnbcpy(
unsigned char (&strDest)[size],
const unsigned char * strSource,
size_t count
); // C++ only
template <size_t size>
unsigned char * _mbsnbcpy_l(
unsigned char (&strDest)[size],
const unsigned char * strSource,
size_t count,
_locale_t locale
); // C++ only
パラメーター
strDest
文字列のコピー先。
strSource
コピーする文字列。
count
コピー対象のバイト数。
locale
使用するロケール。
戻り値
_mbsnbcpy
は、コピー先文字列へのポインターを返します。 エラーを示す戻り値は予約されていません。
解説
_mbsnbcpy
関数は、count
バイト数を strSource
から strDest
にコピーします。 count
が strDest
のサイズを超えている場合、またはコピー元とコピー先の文字列が重なり合う場合の _mbsnbcpy
の動作は未定義です。
null ポインターの場合strSource
、strDest
この関数は、「パラメーターの検証」の説明に従って無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、関数は NULL
を返し、errno
を EINVAL
に設定します。
出力値は、ロケールの LC_CTYPE
カテゴリ設定の設定によって影響を受けます。 詳細については、setlocale
を参照してください。 これらの関数のバージョンは同じですが、サフィックスを持 _l
たない関数は現在のロケールを使用し、サフィックスを持つ _l
バージョンでは代わりに渡されるロケール パラメーターを使用します。 詳細については、「 Locale」を参照してください。
重要
これらの関数は、バッファー オーバーランの脅威に対して脆弱な場合があります。 バッファー オーバーランを使用すると任意の攻撃者のコードを実行できるため、認められていない特権の昇格が発生し、システムを危険にさらすことがあります。 詳細については、「バッファー オーバーランの回避」を参照してください。
C++ では、これらの関数にテンプレートのオーバーロードがあります。このオーバーロードは、これらの関数に対応するセキュリティを強化された新しい関数を呼び出します。 詳細については、「セキュリティで保護されたテンプレート オーバーロード」を参照してください。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
---|---|---|---|
_tcsncpy |
strncpy |
_mbsnbcpy |
wcsncpy |
_tcsncpy_l |
_strncpy_l |
_mbsnbcp_l |
_wcsncpy_l |
必要条件
ルーチンによって返される値 | 必須ヘッダー |
---|---|
_mbsnbcpy |
<mbstring.h> |
_mbsnbcpy_l |
<mbstring.h> |
互換性の詳細については、「 Compatibility」を参照してください。
関連項目
文字列操作
_mbsnbcat
, _mbsnbcat_l
_mbsnbcmp
, _mbsnbcmp_l
_strncnt
, _wcsncnt
, _mbsnbcnt
, _mbsnbcnt_l
, _mbsnccnt
, _mbsnccnt_l
_mbsnbset
, _mbsnbset_l
strncpy
, _strncpy_l
, wcsncpy
, _wcsncpy_l
, _mbsncpy
, _mbsncpy_l
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示