_strnset、_strnset_l、_wcsnset、_wcsnset_l、_mbsnset、_mbsnset_l

项目
06/09/2015

初始化字符串到特定字符。有关这些函数存在的更多安全版本；请参见 _strnset_s、_strnset_s_l、_wcsnset_s、_wcsnset_s_l、_mbsnset_s、_mbsnset_s_l。

重要

_mbsnset 和 _mbsnset_l 不能在 Windows 运行时中执行的应用程序中使用。有关详细信息，请参见 CRT functions not supported with /ZW（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 是空指针，则会调用无效参数处理程序，如参数验证中所述。如果允许继续执行，_mbsnset 返回空，设置 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 );
}