_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

Artículo
04/10/2013

Establece los caracteres de una cadena en un carácter.Versiones más seguras de estas funciones están disponibles; vea _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l.

Importante
_mbsset y _mbsset_l no se pueden utilizar en las aplicaciones que se ejecutan en Windows en tiempo de ejecución.Para obtener más información, vea Funciones CRT no compatibles 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
);

Parámetros

str
Cadena terminada en null que se establecerá.
c
Valor de carácter.
locale
Configuración regional a utilizar.

Valor devuelto

Devuelve un puntero a la cadena modificada.

Comentarios

La función de _strset establece todos los caracteres (excepto el carácter null de terminación) de str a c, a char._wcsset y _mbsset_l son versiones de caracteres anchos y de multibyte- carácter de _strset, y los tipos de datos de los argumentos y valores devueltos varían en consecuencia.Estas funciones se comportan exactamente igual de otra manera.

_mbsset valida sus parámetros.Si str es un puntero NULL, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar,_mbsset devuelve NULL y establece errno a EINVAL._strset y _wcsset no validan sus parámetros.

El valor de salida se ve afectado por el valor de la categoría de LC_CTYPE de configuración regional; vea setlocale, _wsetlocale para obtener más información.Las versiones de estas funciones son idénticas, excepto en que las que no tienen el uso del sufijo de _l la configuración regional actual y las que tienen el sufijo de _l en su lugar utilice el parámetro de configuración regional que se pasa.Para obtener más información, vea Configuración regional.

Nota sobre la seguridad
Estas funciones pueden ser vulnerables a amenazas de saturación del búfer.Las saturaciones del búfer se pueden utilizar para ataques del sistema porque pueden producir una elevación de privilegios injustificable.Para obtener más información, vea Para evitar las saturaciones del búfer.

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tcsset	_strset	_mbsset	_wcsset
_tcsset_l	_strset_l	_mbsset_l	_wcsset_l

Requisitos

Rutina	Encabezado necesario
_strset	<string.h>
_strset_l	<tchar.h>
_wcsset	<string.h> o <wchar.h>
_wcsset_l	<tchar.h>
_mbsset, _mbsset_l	<mbstring.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad.

Ejemplo

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