_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l

Articolo
03/26/2013

Inizializzare i caratteri di una stringa con un carattere specificato.Più versioni sicure di queste funzioni esistenti, vedere _strnset_s, _strnset_s_l, _wcsnset_s, _wcsnset_s_l, _mbsnset_s, _mbsnset_s_l.

Importante
_mbsnset e _mbsnset_l non possono essere utilizzati nelle applicazioni eseguite nelle finestre runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /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
);

Parametri

str
Stringa da modificare.
c
Impostazione del carattere.
count
Numero di caratteri da impostare.
locale
Impostazioni locali da utilizzare.

Valore restituito

Restituisce un puntatore alla stringa modificata.

Note

Set di funzione di _strnset, al massimo, i primi caratteri di count di str a c (convertito in char).Se count è maggiore della lunghezza di str, la lunghezza di str viene utilizzata al posto di count.

_wcsnset e _mbsnsetdisponibili versioni a caratteri estesi e di caratteri multibyte di _strnset.Gli argomenti della stringa e il valore restituito di _wcsnsetsono stringhe di caratteri estesi, tali di _mbsnset sono stringhe di caratteri multibyte.Altrimenti queste tre funzioni si comportano in modo identico.

_mbsnsetconvalida dei parametri; se str è un puntatore null, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, i risultati di _mbsnsetNULL e imposta errnoa EINVAL._strnset e _wcsnset non convalidano i relativi parametri.

Il valore di output è interessato dall'impostazione dell'impostazione di categoria di LC_CTYPEdelle impostazioni locali; vedere setlocale per ulteriori informazioni.Le versioni di queste funzioni senza il suffisso di _l utilizzano le impostazioni locali correnti per questo comportamento dipendente dalle impostazioni locali; le versioni con il suffisso di_l sono identiche ma utilizzano il parametro delle impostazioni locali passato.Per ulteriori informazioni, vedere Impostazioni locali.

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcsnset	_strnset	_mbsnbset	_wcsnset
_tcsnset_l	_strnset_l	_mbsnbset_l	_wcsnset_l

Requisiti

Routine	Intestazione obbligatoria
_strnset	<string.h>
_strnset_l	<tchar.h>
_wcsnset	<string.h> o <wchar.h>
_wcsnset_l	<tchar.h>
_mbsnset, _mbsnset_l	<mbstring.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

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