_strset_s， _strset_s_l， _wcsset_s， _wcsset_s_l， _mbsset_s， _mbsset_s_l

项目
04/10/2013

将字符串的字符与字符。这些是 _strset， _strset_l， _wcsset， _wcsset_l， _mbsset， _mbsset_l 的版本与安全增强如 CRT中的安全功能所述。

重要

_mbsset_s 和 _mbsset_s_l 不能在运行时的窗口执行的应用程序。有关更多信息，请参见 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 是 null 指针，或者 numberOfElements 参数小于或等于 0，或传递的块没有 null 终止，则无效参数调用处理程序，如参数验证所述。如果执行允许继续，这些函数返回 EINVAL 并将 errno到 EINVAL。

备注

_strset_s 功能集 str 所有字符。c (转换为 char)，不包括终止 null 字符)。 _wcsset_s 和 _mbsset_s 是 _strset_s的宽字符和多字节字符版本。参数和返回值的数据类型相应地改变。这些功能否则具有相同的行为。

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

这些函数的" debug "版本用 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 );
}