_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

Articolo
03/26/2013

Imposta i caratteri di una stringa con un carattere.Più versioni sicure di queste funzioni sono disponibili, vedere _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l.

Importante
_mbsset e _mbsset_l non possono essere utilizzati nelle applicazioni eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /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
);

Parametri

str
Stringa con terminazione null da impostare.
c
Impostazione del carattere.
locale
Impostazioni locali da utilizzare.

Valore restituito

Restituisce un puntatore alla stringa modificata.

Note

La funzione di _strset imposta tutti i caratteri (escluso il carattere di terminazione null) di str a c, convertito in char._wcsset e _mbsset_l disponibili versioni a caratteri estesi e di caratteri multibyte di _strsete i tipi di dati degli argomenti e valori restituiti variano di conseguenza.Altrimenti queste funzioni si comportano in modo identico.

_mbsset convalida i suoi parametri.Se str è un puntatore a null, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare,_mbsset restituisce NULL e imposta errno a EINVAL._strset e _wcsset non convalidano i relativi parametri.

Il valore di output è interessato dall'impostazione dell'impostazione di categoria di LC_CTYPE delle impostazioni locali; vedere setlocale, _wsetlocale per ulteriori informazioni.Le versioni di queste funzioni sono identiche, eccetto quelli che non dispongano dell'utilizzo di _l le impostazioni locali correnti e quelle che eseguono il suffisso di _l utilizzare invece il parametro delle impostazioni locali passato.Per ulteriori informazioni, vedere Impostazioni locali.

Nota sulla sicurezza
Queste funzioni potrebbero essere vulnerabile a rischi di sovraccarico del buffer.I sovraccarichi del buffer possono essere utilizzati per gli attacchi di sistema perché possono causare un'elevazione dei privilegi ingiustificata.Per ulteriori informazioni, vedere Evitare sovraccarichi del buffer.

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcsset	_strset	_mbsset	_wcsset
_tcsset_l	_strset_l	_mbsset_l	_wcsset_l

Requisiti

Routine	Intestazione obbligatoria
_strset	<string.h>
_strset_l	<tchar.h>
_wcsset	<string.h> o <wchar.h>
_wcsset_l	<tchar.h>
_mbsset, _mbsset_l	<mbstring.h>

Per informazioni aggiuntive di compatibilità, vedere Compatibilità.

Esempio

// 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 );
}