_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l

Artigo
08/25/2010

Inicialize caracteres de uma seqüência de caracteres para um determinado caractere.Versões mais seguras dessas funções existem; consulte _strnset_s, _strnset_s_l, _wcsnset_s, _wcsnset_s_l, _mbsnset_s, _mbsnset_s_l.

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

Parâmetros

str
Seqüência de caracteres a ser alterado.
c
Configuração de caractere.
count
Número de caracteres a ser conjunto.
locale
Localidade usar.

Valor de retorno

Retorna um ponteiro para a seqüência alterada.

Comentários

The _strnset função define, no máximo, o primeiro count caracteres do str para c (convertido em char). If count é maior do que o comprimento de str, o tamanho de str é usado em vez de count.

_wcsnset e _mbsnset são versões de caractere largo e caracteres de multibyte de _strnset. Os argumentos de seqüência de caractere e o valor retornado do _wcsnset são caractere largos strings; as de _mbsnset são seqüências de caractere de multibyte. Especifique estas três funções identicamente outro comportam.

_mbsnset valida sistema autônomo parâmetros; se str é um ponteiro nulo, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro . Se a execução for permitida para continuar, _mbsnset retorna nulo e define errno para EINVAL. _strnset e _wcsnset não validam seus parâmetros.

O valor de saída é afetado pela configuração do LC_CTYPE categoria de configuração da localidade; consulte setlocale para obter mais informações.As versões dessas funções sem o _l sufixo use a localidade corrente para esse comportamento dependente de localidade; as versões com o _l sufixo são idênticas exceto que usarem o parâmetro de localidade passado em vez disso. For more information, see Localidade.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tcsnset	_strnset	_mbsnbset	_wcsnset
_tcsnset_l	_strnset_l	_mbsnbset_l	_wcsnset_l

Requisitos

Rotina	Cabeçalho necessário
_strnset	<string.h>
_strnset_l	<tchar.h>
_wcsnset	<string.h> ou <wchar.h>
_wcsnset_l	<tchar.h>
_mbsnset, _mbsnset_l	<mbstring.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

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

Before: This is a test After:  **** is a test