Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo se tradujo de forma manual. 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

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.

Nota importante Importante

_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

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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft