_mbsnbset_s
, _mbsnbset_s_l
指定された文字にマルチバイト文字列の最初の n バイトを設定します。 これらのバージョンでは、「_mbsnbset_l
CRT の_mbsnbset
セキュリティ機能」で説明されているように、セキュリティが強化されています。
重要
この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。
構文
errno_t _mbsnbset_s(
unsigned char *str,
size_t size,
unsigned int c,
size_t count
);
errno_t _mbsnbset_s_l(
unsigned char *str,
size_t size,
unsigned int c,
size_t count,
_locale_t locale
);
template <size_t size>
errno_t _mbsnbset_s(
unsigned char (&str)[size],
unsigned int c,
size_t count
); // C++ only
template <size_t size>
errno_t _mbsnbset_s_l(
unsigned char (&str)[size],
unsigned int c,
size_t count,
_locale_t locale
); // C++ only
パラメーター
str
変更対象の文字列。
size
文字列バッファーのサイズ。
c
1 バイトまたはマルチバイト文字の設定。
count
設定対象のバイト数。
locale
使用するロケール。
戻り値
正常に終了した場合は 0 を返し、それ以外の場合はエラー コードを返します。
解説
_mbsnbset_s
関数および _mbsnbset_s_l
関数は、最長で count
の最初の str
バイトを c
に設定します。 count
が str
の長さを超えると、その str
の長さが count
の代わりに使用されます。 マルチバイト文字で、指定されたcount
最後のバイトに完全に設定できない場合c
、最後のバイトには空白文字が埋め込まれます。 _mbsnbset_s
最後 _mbsnbset_s_l
に終端の null を str
配置しないでください。
_mbsnbset_s
と _mbsnbset_s_l
は _mbsnset
と似ていますが c
の count
文字ではなく count
バイトを設定する点が異なります。
値が NULL
count
0 の場合str
、「パラメーターの検証」で説明されているように、この関数は無効なパラメーター例外を生成します。 実行の継続が許可された場合、 errno
が EINVAL
に設定され、関数が NULL
のセキュリティが強化されたバージョンです。 また、有効なマルチバイト文字でない場合c
は、それに設定EINVAL
され、errno
代わりにスペースが使用されます。
出力値は、ロケールの LC_CTYPE
カテゴリ設定の設定によって影響を受けます。 詳細については、setlocale
を参照してください。 この関数の _mbsnbset_s
バージョンは、ロケールに依存するこの動作について現在のロケールを使用します。_mbsnbset_s_l
バージョンは、渡されるロケール パラメーターを代わりに使用することを除いて、同じです。 詳細については、「 Locale」を参照してください。
C++ では、テンプレートのオーバーロードによってこれらの関数を簡単に使用できます。オーバーロードでは、バッファー長を自動的に推論できるため、サイズ引数を指定する必要がなくなります。 詳細については、「セキュリティで保護されたテンプレート オーバーロード」を参照してください。
これらの関数のデバッグ ライブラリ バージョンでは、最初にバッファーを 0xFE で埋めます。 この動作を無効にするには、_CrtSetDebugFillThreshold
を使用します。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
---|---|---|---|
_tcsnset_s |
_strnset_s |
_mbsnbset_s |
_wcsnset_s |
_tcsnset_s_l |
_strnset_s _l |
_mbsnbset_s_l |
_wcsnset_s_l |
必要条件
ルーチンによって返される値 | 必須ヘッダー |
---|---|
_mbsnbset_s |
<mbstring.h> |
_mbsnbset_s_l |
<mbstring.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
// crt_mbsnbset_s.c
#include <mbstring.h>
#include <stdio.h>
int main( void )
{
char string[15] = "This is a test";
/* Set not more than 4 bytes of string to be *'s */
printf( "Before: %s\n", string );
_mbsnbset_s( string, sizeof(string), '*', 4 );
printf( "After: %s\n", string );
}
出力
Before: This is a test
After: **** is a test
関連項目
文字列操作
_mbsnbcat
, _mbsnbcat_l
_strnset
, _strnset_l
, _wcsnset
, _wcsnset_l
, _mbsnset
, _mbsnset_l
_strset
, _strset_l
, _wcsset
, _wcsset_l
, _mbsset
, _mbsset_l
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示