_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Artículo
04/10/2013

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.

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

Parámetros

str
Cadena a colocar.
numberOfElements
Tamaño del búfer.
locale
La configuración regional a utilizar.

Valor devuelto

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.

Comentarios

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