_strnset， _strnset_l， _wcsnset， _wcsnset_l， _mbsnset， _mbsnset_l

项目
04/10/2013

初始化字符串的字符与特定字符。这些功能的更安全版本存在；请参见 _strnset_s， _strnset_s_l， _wcsnset_s， _wcsnset_s_l， _mbsnset_s， _mbsnset_s_l。

重要

_mbsnset 和 _mbsnset_l 不能在运行时的窗口执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /ZW。

char *_strnset(
   char *str,
   int c,
   size_t count 
);
char *_strnset_l(
   char *str,
   int c,
   size_t count,
   locale_t locale
);
wchar_t *_wcsnset(
   wchar_t *str,
   wchar_t c,
   size_t count 
);
wchar_t *_wcsnset_l(
   wchar_t *str,
   wchar_t c,
   size_t count,
   _locale_t locale
);
unsigned char *_mbsnset(
   unsigned char *str,
   unsigned int c,
   size_t count 
);
unsigned char *_mbsnset_l(
   unsigned char *str,
   unsigned int c,
   size_t count,
   _locale_t locale
);

参数

str
要修改的字符串。
c
字符集。
count
要设置的字符数。
locale
使用的区域设置。

返回值

返回指向该修改后的字符串。

备注

_strnset功能集，至多，str 第一 count 字符。c (转换为 char)。如果 count 比 str的长度时，str 的长度使用而不是 count。

_wcsnset 和 _mbsnset是 _strnset的宽字符和多字节字符版本。字符串的参数和返回 _wcsnset的值是宽字符字符串；这些 _mbsnset 的多字节字符字符串。这三个功能否则具有相同的行为。

_mbsnset验证其参数；如果 str 是 null 指针，无效参数调用处理程序，如参数验证所述。如果执行允许继续，_mbsnset返回 NULL 和设置 errno到 EINVAL。 _strnset 和 _wcsnset 不验证方法的参数。

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

一般文本例程映射

TCHAR.H 实例	未定义的_UNICODE & _MBCS	定义的_MBCS	定义的_UNICODE
_tcsnset	_strnset	_mbsnbset	_wcsnset
_tcsnset_l	_strnset_l	_mbsnbset_l	_wcsnset_l

要求

实例	必需的标头
_strnset	<string.h>
_strnset_l	<tchar.h>
_wcsnset	<string.h> 或 <wchar.h>
_wcsnset_l	<tchar.h>
_mbsnset, _mbsnset_l	<mbstring.h>

有关其他的兼容性信息，请参见中介绍的兼容性。

示例

// crt_strnset.c
// compile with: /W3
#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[15] = "This is a test";
   /* Set not more than 4 characters of string to be *'s */
   printf( "Before: %s\n", string );
   _strnset( string, '*', 4 ); // C4996
   // Note: _strnset is deprecated; consider using _strnset_s
   printf( "After:  %s\n", string );
}