_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

Artigo
03/12/2013

Define caracteres de uma cadeia de caracteres em um caractere.Versões mais seguros dessas funções estão disponíveis; consulte _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l.

Importante
_mbsset e _mbsset_l não podem ser usados em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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 );

Parâmetros

str
Cadeia de caracteres NULL- finalizada a ser definida.
c
Configuração de caracteres.
locale
A localidade usar.

Valor de retorno

Retorna um ponteiro para a cadeia de caracteres modificada.

Comentários

A função de _strset define todos os caracteres (exceto o caractere de terminação zero) de str a c, convertido em char._wcsset e _mbsset_l são versões de largo- caractere e o caractere multibyte- de _strset, e os tipos de dados dos argumentos e valores de retorno variam de acordo.Essas funções se comportam de forma idêntica.

_mbsset valida os seus parâmetros.Se str é um ponteiro zero, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar,_mbsset retorna NULL e defina errno a EINVAL._strset e _wcsset não validam seus parâmetros.

O valor de saída é afetado pela configuração da categoria de LC_CTYPE de localidade; consulte setlocale, wsetlocale para mais informações.As versões dessas funções são idênticas, exceto as que não têm o uso do sufixo de _l a localidade atual e as seguintes que têm o sufixo de _l usar o parâmetro de localidade que é passado.Para obter mais informações, consulte Localidade.

Observação de segurança
Essas funções podem ser vulneráveis armazenar em buffer ameaças de estouro.Estouros de buffer podem ser usadas para ataques do sistema como podem causar uma despropositado elevação de privilégio.Para obter mais informações, consulte Evitando estouros de buffer.

Mapeamentos da rotina de Genérico- texto

Rotina de TCHAR.H	_UNICODE & _MBCS não definidos	_MBCS definido	_UNICODE definido
_tcsset	_strset	_mbsset	_wcsset
_tcsset_l	_strset_l	_mbsset_l	_wcsset_l

Requisitos

Rotina	Cabeçalho necessário
_strset	<string.h>
_strset_l	<tchar.h>
_wcsset	<string.h> ou <wchar.h>
_wcsset_l	<tchar.h>
_mbsset, _mbsset_l	<mbstring.h>

Para informações extras de compatibilidade, consulte Compatibilidade.

Exemplo

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