_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

Článek
03/26/2013

Sady znaků řetězce na znak.Bezpečnější verze tyto funkce jsou k dispozici; see _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l.

Důležité
_mbsseta _mbsset_l nelze použít v aplikacích, které jsou spuštěny v Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

char *_strset(
   char *str,
   int c 
);
char *_strset_l(
   char *str,
   int c,
   locale_t locale
);
wchar_t *_wcsset(
   wchar_t *str,
   wchar_t c 
);
wchar_t *_wcsset_l(
   wchar_t *str,
   wchar_t c,
   locale_t locale
);
unsigned char *_mbsset(
   unsigned char *str,
   unsigned int c 
);
unsigned char *_mbsset_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
);

Parametry

str
Řetězec zakončený hodnotou Null nastavit.
c
Nastavení znaků.
locale
Chcete-li národní prostředí pro použití.

Vrácená hodnota

Vrací ukazatel na řetězec změněné.

Poznámky

_strset Funkce nastaví všechny znaky (s výjimkou ukončující znak null) str na c, převedeny na char._wcsseta _mbsset_l jsou verze širokého znaku a vícebajtové znakové sady _strset, a typy dat argumenty a vrácené hodnoty se liší podle toho.Tyto funkce chovat identicky jinak.

_mbssetověřuje jeho parametry.Pokud str je ukazatel s hodnotou null, je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů.Je-li pokračovat, je povoleno zpracování_mbsset vrátí NULL a errno na EINVAL._strseta _wcsset nelze ověřit jejich parametry.

Výstupní hodnota je ovlivněna nastavením LC_CTYPE kategorie nastavení národního prostředí; Viz setlocale _wsetlocale Další informace.Verze tyto funkce jsou stejné, s tím rozdílem, že ty, které nechcete mít _l příponu použít aktuální národní prostředí a ty, které mají _l přípony, použijte parametr locale, který je předaný v.Další informace naleznete v tématu Národní prostředí.

Poznámka k zabezpečení
Tyto funkce může být zranitelný vůči hrozbám přetečení vyrovnávací paměti.Přeběhy vyrovnávací paměti lze použít pro napadení systému, protože mohou způsobit, že bude vyplacena neoprávněně zvýšení úrovně oprávnění.Další informace naleznete v tématu Zamezení způsobí přetečení vyrovnávací paměti.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tcsset	_strset	_mbsset	_wcsset
_tcsset_l	_strset_l	_mbsset_l	_wcsset_l

Požadavky

Byla zahájena rutina	Požadované záhlaví
_strset	<string.h>
_strset_l	<tchar.h>
_wcsset	<string.h> nebo <wchar.h>
_wcsset_l	<tchar.h>
_mbsset, _mbsset_l	<mbstring.h>

Další informace o kompatibilitě, viz Kompatibilita.

Příklad

// crt_strset.c
// compile with: /W3

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[] = "Fill the string with something.";
   printf( "Before: %s\n", string );
   _strset( string, '*' ); // C4996
   // Note: _strset is deprecated; consider using _strset_s instead
   printf( "After:  %s\n", string );
}