_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l
div
EOF
TOC
Collapse the table of content
Expand the table of content
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l

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.

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

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.

Devuelve un puntero a la cadena modificada.

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

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.

// 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 );
}
Antes: Esto es una prueba después de: el **** es una prueba

Adiciones de comunidad

AGREGAR
Mostrar:
© 2016 Microsoft