¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l
div
EOF
Collapse the table of content
Expand the table of content
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

_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Convierte una cadena en mayúsculas, utilizando la configuración regional actual o una configuración regional especificada pasó. Éstas son versiones de _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr con mejoras de seguridad como se describe en Características de seguridad en CRT.

Nota importante Importante

_mbsupr_s y _mbsupr_s_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.

errno_t _strupr_s(
   char *str,
   size_t numberOfElements
);
errno_t _wcsupr_s(
   wchar_t * str,
   size_t numberOfElements
);
errno_t _strupr_s_l(
   char * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _wcsupr_s_l(
   wchar_t * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _mbsupr_s(
   unsigned char *str,
   size_t numberOfElements
);
errno_t _mbsupr_s_l(
   unsigned char *str,
   size_t numberOfElements,
   _locale_t locale
);
template <size_t size>
errno_t _strupr_s(
   char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcsupr_s(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _strupr_s_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _wcsupr_s_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _mbsupr_s(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbsupr_s_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

str

Cadena a colocar.

numberOfElements

Tamaño del búfer.

locale

La configuración regional a utilizar.

Cero si correctamente; un código de error distinto del error.

Estas funciones validan sus parámetros. Si str es un puntero de 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, las funciones EINVAL return y errno determinado a EINVAL. Si numberOfElements es menor que la longitud de la cadena, funciones ERANGE return y de errno determinado a ERANGE.

La función de _strupr_s convierte, en su lugar, cada minúsculas en str a mayúsculas. _wcsupr_s constituye la versión con caracteres anchos de _strupr_s. _mbsupr_s es la versión de caracteres de multi- byte de _strupr_s.

La conversión está determinada por el valor de categoría de LC_CTYPE de la configuración regional. Otros caracteres no resultan afectados. Para obtener más información sobre LC_CTYPE, vea setlocale. Las versiones de estas funciones sin el sufijo de _l utilizan la configuración regional actual; las visiones con el sufijo de _l son idénticas salvo que utilizan la configuración regional pasado en su lugar. Para obtener más información, vea Configuración regional.

En C++, mediante estas funciones es simplificado con sobrecargas de plantilla; las sobrecargas pueden deducir la longitud de búfer automáticamente (que elimina la necesidad de especificar un argumento de tamaño) y automáticamente pueden reemplazar anterior, funciones de no Secure con sus más recientes, seguros homólogos. Para obtener más información, vea Sobrecargas de plantilla de seguridad.

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

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcsupr_s

_strupr_s

_mbsupr_s

_wcsupr_s

_tcsupr_s_l

_strupr_s_l

_mbsupr_s_l

_wcsupr_s_l

Rutina

Encabezado necesario

_strupr_s , _strupr_s_l

<string.h>

_wcsupr_s , _wcsupr_s_l, _mbsupr_s, _mbsupr_s_l

<string.h> o <wchar.h>

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft