_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l

Artículo
04/10/2013

Inicializa los caracteres de una cadena en un carácter dado.Versiones más seguras de estas funciones existen; vea _strnset_s, _strnset_s_l, _wcsnset_s, _wcsnset_s_l, _mbsnset_s, _mbsnset_s_l.

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

Parámetros

str
Cadena que se va a modificar.
c
Valor de carácter.
count
Número de caracteres que se va a establecer.
locale
Configuración regional a utilizar.

Valor devuelto

Devuelve un puntero a la cadena modificada.

Comentarios

Los conjuntos de la función de _strnset, como máximo, los primeros caracteres de count de str a c (convierte en char).Si count es mayor que la longitud de str, la longitud de str se utiliza en lugar de count.

_wcsnset y _mbsnset son versiones de caracteres anchos y de multibyte- carácter de _strnset.Los argumentos de cadena y el valor devuelto de _wcsnset son cadenas de caracteres; las de _mbsnset son cadenas de multibyte- carácter.Estas tres funciones se comportan exactamente igual de otra manera.

_mbsnset 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, _mbsnset devuelve NULL y establece errno a EINVAL._strnset y _wcsnset 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 para obtener más información.Las versiones de estas funciones sin el sufijo de _l utilizan la configuración regional actual para este comportamiento configuración regional-dependiente; las versiones con el sufijo de _l son idénticas salvo que utilizan el parámetro locale pasado en su lugar.Para obtener más información, vea Configuración regional.

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tcsnset	_strnset	_mbsnbset	_wcsnset
_tcsnset_l	_strnset_l	_mbsnbset_l	_wcsnset_l

Requisitos

Rutina	Encabezado necesario
_strnset	<string.h>
_strnset_l	<tchar.h>
_wcsnset	<string.h> o <wchar.h>
_wcsnset_l	<tchar.h>
_mbsnset, _mbsnset_l	<mbstring.h>

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

Ejemplo

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