_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l
Inicializujte znaků řetězce na daný znak.Existují bezpečnější verze těchto funkcí; see _strnset_s, _strnset_s_l, _wcsnset_s, _wcsnset_s_l, _mbsnset_s, _mbsnset_s_l.
![]() |
---|
_mbsnseta _mbsnset_l nelze použít v aplikacích, které jsou spuštěny v systému Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /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
);
Parametry
str
Řetězec, který má být změněn.c
Nastavení znaků.count
Počet znaků, které chcete nastavit.locale
Chcete-li národní prostředí pro použití.
Vrácená hodnota
Vrací ukazatel na řetězec změněné.
Poznámky
_strnset Funkce nastaví nanejvýš první count znaky str na c (převedeny na char).Pokud count je větší než délka str, délka str se používá místo count.
_wcsnseta _mbsnset jsou verze širokého znaku a vícebajtové znakové sady _strnset.Řetězcové argumenty a vrácené hodnoty _wcsnset jsou řetězci širokého znaku; u _mbsnset jsou vícebajtové znakové řetězce.Tyto tři funkce chovat identicky jinak.
_mbsnsetověř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í _mbsnset vrátí hodnotu NULL a nastaví errno na EINVAL._strnseta _wcsnset nelze ověřit jejich parametry.
Výstupní hodnota je ovlivněna nastavením LC_CTYPE kategorie nastavení národního prostředí; Viz setlocale pro další informace.Verze těchto funkcí, aniž by _l příponu použít aktuální národní prostředí pro toto chování závislé na národním prostředí; verze s_l s tím rozdílem, že používají místo něho předán parametr locale shodná přípona.Další informace naleznete v tématu Národní prostředí.
Mapování rutiny obecného textu
TCHAR.Byla zahájena rutina h |
_UNICODE & _MBCS není definováno |
_MBCS, definice |
_UNICODE definována |
---|---|---|---|
_tcsnset |
_strnset |
_mbsnbset |
_wcsnset |
_tcsnset_l |
_strnset_l |
_mbsnbset_l |
_wcsnset_l |
Požadavky
Byla zahájena rutina |
Požadované záhlaví |
---|---|
_strnset |
<string.h> |
_strnset_l |
<tchar.h> |
_wcsnset |
<string.h> nebo <wchar.h> |
_wcsnset_l |
<tchar.h> |
_mbsnset, _mbsnset_l |
<mbstring.h> |
Další informace o kompatibilitě, viz Compatibility v úvodu.
Příklad
// 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 );
}