_strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l
Impostare i caratteri di una stringa con un carattere.Queste sono versioni di _strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.
![]() |
---|
_mbsset_s e _mbsset_s_l non possono essere utilizzati nelle applicazioni eseguite nelle finestre runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW. |
errno_t _strset_s(
char *str,
size_t numberOfElements,
int c
);
errno_t _strset_s_l(
char *str,
size_t numberOfElements,
int c,
locale_t locale
);
errno_t _wcsset_s(
wchar_t *str,
size_t numberOfElements,
wchar_t c
);
errno_t *_wcsset_s_l(
wchar_t *str,
size_t numberOfElements,
wchar_t c,
locale_t locale
);
errno_t _mbsset_s(
unsigned char *str,
size_t numberOfElements,
unsigned int c
);
errno_t _mbsset_s_l(
unsigned char *str,
size_t numberOfElements,
unsigned int c,
_locale_t locale
);
Parametri
str
Stringa con terminazione null da impostare.numberOfElements
La dimensione del buffer di str.c
Impostazione del carattere.locale
Impostazioni locali da utilizzare.
Valore restituito
Zero se l'operazione viene completata correttamente, altrimenti un codice di errore.
Queste funzioni convalidano i relativi argomenti.Se str è un puntatore null, o argomento di numberOfElements è minore o uguale a 0, o il blocco passato non è con terminazione null, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni EINVAL di ritorno e errnostabilito a EINVAL.
Note
La funzione di _strset_s imposta tutti i caratteri di str a c (convertito in char), escluso il carattere di terminazione null._wcsset_s e _mbsset_s sono versioni a caratteri di tipo "wide" e di caratteri multibyte di _strset_s.I tipi di dati degli argomenti e valori restituiti variano di conseguenza.Altrimenti queste funzioni si comportano in modo identico.
Il valore di output è interessato dall'impostazione dell'impostazione di categoria LC_CTYPE delle impostazioni locali; vedere setlocale per ulteriori informazioni.Le versioni di queste funzioni senza il suffisso _l utilizzano le impostazioni locali correnti per il comportamento dipendente dalle impostazioni locali; le versioni con il suffisso _l sono identiche, ad eccezione del fatto che utilizzano il parametro delle impostazioni locali che viene passato.Per ulteriori informazioni, vedere Impostazioni locali.
La versione di debug di queste funzioni per prima cosa riempiono il buffer con il valore 0xFD.Per disabilitare questo comportamento, utilizzare _CrtSetDebugFillThreshold.
Mapping di routine a Testo generico
TCHAR.H routine |
_UNICODE & _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
---|---|---|---|
_tcsset_s |
_strset_s |
_mbsset_s |
_wcsset_s |
_tcsset_s_l |
_strset_s_l |
_mbsset_s_l |
_wcsset_s_l |
Requisiti
Routine |
Intestazione obbligatoria |
---|---|
_strset_s |
<string.h> |
_strset_s_l |
<tchar.h> |
_wcsset_s |
<string.h> o <wchar.h> |
_wcsset_s_l |
<tchar.h> |
_mbsset_s, _mbsset_s_l |
<mbstring.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
Esempio
// crt_strset_s.c
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
char string[] = "Fill the string with something.";
printf( "Before: %s\n", string );
_strset_s( string, _countof(string), '*' );
printf( "After: %s\n", string );
}
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione standard C, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di Invocazione della Piattaforma.
Vedere anche
Riferimenti
Interpretazione delle sequenze di caratteri multibyte
_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l