_mbsnbset_s, _mbsnbset_s_l

將多位元組字元字串的前 n 個位元組設定為指定的字元。 這些版本的 _mbsnbset 具有 _mbsnbset_l 安全性增強功能，如 CRT 中的安全性功能中所述 。

重要

這個 API 不能用於在 Windows 執行階段中執行的應用程式。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 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
單一位元組或多位元組字元的設定。

count
要設定的位元組數目。

locale
要使用的地區設定。

傳回值

如果成功則為零，否則為錯誤碼。

備註

_mbsnbset_s 和 _mbsnbset_s_l 函式會將 str 的最多前 count 個位元組設為 c。 如果 count 大於 str 的長度，則會使用 str 的長度，而非 count。 如果 c 是多位元組字元，且無法完全設定為 所 count 指定的最後一個位元組，則最後一個位元組會填補空白字元。 _mbsnbset_s 和 _mbsnbset_s_l 不會在 結尾放置終止 Null str 。

_mbsnbset_s 和 _mbsnbset_s_l 類似 _mbsnset，只不過它們設定 count 位元組，而非 c 的 count 字元。

如果 str 為 NULL 或 count 為零，此函式會產生不正確參數例外狀況，如參數驗證 中所述 。 若允許繼續執行， errno 會設為 EINVAL ，且函式會傳回 NULL中所述。 此外，如果 c 不是有效的多位元組字元， errno 則會設定為 EINVAL ，並改用空格。

輸出值會受到 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>

如需相容性詳細資訊，請參閱相容性。

範例

// 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