_strset_s、_strset_s_l、_wcsset_s、_wcsset_s_l、_mbsset_s、_mbsset_s_l

项目
06/09/2015

将字符串的字符设置为一个字符。 _strset、_strset_l、_wcsset、_wcsset_l、_mbsset、_mbsset_l 的这些版本如 CRT 中的安全功能所述，其安全得到了增强。

重要

_mbsset_s 和 _mbsset_s_l 不能在 Windows 运行时执行的应用程序中使用。有关详细信息，请参见 CRT functions not supported with /ZW（CRT 函数不支持使用/ZW）。

errno_t _strset_s(
   char *str,
   size_t numberOfElements,
   int c 
);
errno_t _strset_s_l(
   char *str,
   size_t numberOfElements,
   int c,
   locale_t locale
);
errno_t _wcsset_s(
   wchar_t *str,
   size_t numberOfElements,
   wchar_t c 
);
errno_t *_wcsset_s_l(
   wchar_t *str,
   size_t numberOfElements,
   wchar_t c,
   locale_t locale
);
errno_t _mbsset_s(
   unsigned char *str,
   size_t numberOfElements,
   unsigned int c 
);
errno_t _mbsset_s_l(
   unsigned char *str,
   size_t numberOfElements,
   unsigned int c,
   _locale_t locale
);

参数

str
设置 null 终止的字符串。
numberOfElements
str缓冲区的大小。
c
字符设置。
locale
要使用的区域设置。

返回值

如果成功，则为零；否则为错误代码。

这些函数验证其参数。如果 str 是空指针，或者 numberOfElements 参数小于或等于 0，或传递的块没有以 null 终止，则调用无效参数处理，如参数验证所述。如果允许执行继续，则这些函数返回EINVAL 并将 errno 设置为EINVAL。

备注

_strset_s 函数将str 的所有字符设置为c（转换为 char），不包括终止 null 字符。 _wcsset_s 和 _mbsset_s 是宽字符，属于 _strset_s 的多节字字符版本。参数和返回值的数据类型相应地改变。否则这些函数具有相同行为。

输出值受区域设置的 LC_CTYPE 类设置影响；有关更多信息，请参见 setlocale。这些不带 _l 后缀的函数的版本使用为该区域设置相关的行为的当前区域设置；带有 _l 后缀的版本相同，只不过它们使用传递的区域设置参数。有关详细信息，请参阅区域设置。

这些函数的调试版本首先用 0xFD 填充缓冲区。若要禁用此行为，请使用 _CrtSetDebugFillThreshold。

一般文本例程映射

TCHAR.H 例程	未定义 _UNICODE & _MBCS	已定义 _MBCS	已定义 _UNICODE
_tcsset_s	_strset_s	_mbsset_s	_wcsset_s
_tcsset_s_l	_strset_s_l	_mbsset_s_l	_wcsset_s_l

要求

例程	必需的标头
_strset_s	<string.h>
_strset_s_l	<tchar.h>
_wcsset_s	<string.h> 或 <wchar.h>
_wcsset_s_l	<tchar.h>
_mbsset_s, _mbsset_s_l	<mbstring.h>

有关兼容性的更多信息，请参见兼容性。

示例

// crt_strset_s.c
#include <string.h>
#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   char string[] = "Fill the string with something.";
   printf( "Before: %s\n", string );
   _strset_s( string, _countof(string), '*' );
   printf( "After:  %s\n", string );
}