_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l
y
div
eof
not
or
xor
TOC
Collapse the table of content
Expand the table of content
Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés

_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

 

Pone una cadena en mayúsculas usando la configuración regional actual o la configuración regional especificada que se pasa.Estas versiones de _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr tienen mejoras de seguridad, como se describe en Características de seguridad de CRT.

System_CAPS_importantImportante

_mbsupr_s y _mbsupr_s_l no se pueden 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 _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 que se va a poner en mayúsculas.

numberOfElements

Tamaño del búfer.

locale

Configuración regional que se va a usar.

Devuelve cero si se ejecuta correctamente; devuelve un código de error de valor distinto de cero si se produce un error.

Estas funciones validan sus parámetros.Si str es un puntero NULL, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros.Si la ejecución puede continuar, las funciones devuelven EINVAL y establecen errno en EINVAL.Si numberOfElements es menor que la longitud de la cadena, las funciones devuelven ERANGE y establecen errno en ERANGE.

La función _strupr_s convierte, en su sitio, cada minúscula de str en mayúscula. _wcsupr_s es la versión con caracteres anchos de _strupr_s. _mbsupr_s es la versión de caracteres multibyte de _strupr_s.

El valor de la categoría LC_CTYPE de la configuración regional determina la conversión.Otros caracteres no resultan afectados.Para obtener más información sobre LC_CTYPE, vea setlocale.Las versiones de estas funciones sin el sufijo _l usan la configuración regional actual; las versiones con el sufijo _l son idénticas salvo que usan 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 se simplifica con las sobrecargas de plantilla; las sobrecargas pueden realizar una inferencia automáticamente de la longitud de búfer (lo que elimina la necesidad de especificar un argumento de tamaño) y pueden reemplazar automáticamente funciones anteriores no seguras con sus homólogos seguros más recientes.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

_tcsupr_s

_strupr_s

_mbsupr_s

_wcsupr_s

_tcsupr_s_l

_strupr_s_l

_mbsupr_s_l

_wcsupr_s_l

Requisitos

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 más información sobre compatibilidad, vea Compatibilidad.

Equivalente en .NET Framework

Mostrar:
© 2016 Microsoft