Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

_mbsnbset_s, _mbsnbset_s_l

Establece los primeros n bytes de una cadena de caracteres multibyte en un carácter especificado. Estas versiones de _mbsnbset, _mbsnbset_l tienen mejoras de seguridad, como se describe en Características de seguridad de CRT.

Nota importante Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas con /ZW.

errno_t _mbsnbset_s(
   unsigned char *str,
   size_t size,
   unsigned int c,
   size_t count 
);
errno_t _mbsnbset_s_l(
   unsigned char *str,
   size_t size,
   unsigned int c,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbset_s(
   unsigned char (&str)[size],
   unsigned int c,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbset_s_l(
   unsigned char (&str)[size],
   unsigned int c,
   size_t count,
   _locale_t locale
); // C++ only

str

Cadena que se va a modificar.

size

El tamaño del búfer de cadena.

c

Valor del carácter de un solo byte o multibyte.

count

Número de bytes que se van a establecer.

locale

Configuración regional que se va a usar.

Cero si correctamente; si no, un código de error.

Las funciones _mbsnbset_s y _mbsnbset_s_l establecen, como máximo, los primeros count bytes de str en c. Si count es mayor que la longitud de str, se usa la longitud de str en lugar de count. Si c es un carácter multibyte y no se puede establecer totalmente en el byte último especificado por count, byte último se completa con un espacio. _mbsnbset_s y _mbsnbset_s_l no colocan un carácter null final al final de str.

_mbsnbset_s y _mbsnbset_s_l se parecen a _mbsnset, salvo que establecen los bytes de count en lugar de caracteres de count de c.

Si str es NULL o count es cero, esta función genera una excepción no válida del parámetro, como se describe en Validación de parámetros. Si la ejecución puede continuar, errno se establece en EINVAL y la función devuelve NULL. Además, si c no es un carácter multibyte válido, errno se establece en EINVAL y se usa un espacio en su lugar.

El valor de salida se ve afectado por el valor de la categoría LC_CTYPE de la configuración regional; vea setlocale, _wsetlocale para obtener más información. La versión de _mbsnbset_s de esta función usa la configuración regional actual para este comportamiento configuración regional- dependiente; la versión de _mbsnbset_s_l es idéntica salvo que en su lugar utiliza el parámetro de configuración regional que se pasa. Para obtener más información, vea Configuración regional.

En C++, el uso de estas funciones es simplificado con sobrecargas de plantilla; las sobrecargas pueden deducir longitud de búfer automáticamente y por tanto eliminar la necesidad de especificar un argumento size. Para obtener más información, vea Sobrecargas de plantilla seguras.

Las versiones de depuración de estas funciones rellenan primero el búfer con 0xFD. Para deshabilitar este comportamiento, use _CrtSetDebugFillThreshold.

Asignaciones de rutina de texto genérico

Rutina Tchar.h

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcsnset_s

_strnset_s

_mbsnbset_s

_wcsnset_s

_tcsnset_s_l

_strnset_s _l

_mbsnbset_s_l

_wcsnset_s_l

Rutina

Encabezado necesario

_mbsnbset_s

<mbstring.h>

_mbsnbset_s_l

<mbstring.h>

Para obtener más información de compatibilidad, vea Compatibilidad.

// crt_mbsnbset_s.c
#include <mbstring.h>
#include <stdio.h>

int main( void )
{
   char string[15] = "This is a test";
   /* Set not more than 4 bytes of string to be *'s */
   printf( "Before: %s\n", string );
   _mbsnbset_s( string, sizeof(string), '*', 4 );
   printf( "After:  %s\n", string );
}

            
              Antes: This is a test
Después: **** is a test
            
          

No es aplicable Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft