_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Convierte una cadena a mayúsculas. Hay disponibles versiones más seguras de estas funciones; consulte _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

Importante

_mbsupr y _mbsupr_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 en aplicaciones de la Plataforma universal de Windows.

Sintaxis

char *_strupr(
   char *str
);
wchar_t *_wcsupr(
   wchar_t *str
);
unsigned char *_mbsupr(
   unsigned char *str
);
char *_strupr_l(
   char *str,
   _locale_t locale
);
wchar_t *_wcsupr_l(
   wchar_t *str,
   _locale_t locale
);
unsigned char *_mbsupr_l(
   unsigned char *str,
   _locale_t locale
);
template <size_t size>
char *_strupr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcsupr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbsupr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strupr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcsupr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbsupr_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

Parámetros

str
Cadena que se va a poner en mayúsculas.

locale
Configuración regional que se va a usar.

Valor devuelto

Devuelve un puntero a la cadena modificada. Dado que la modificación se hace en contexto, el puntero devuelto es el mismo que el puntero que se pasa como argumento de entrada. No se reserva ningún valor devuelto para indicar un error.

Comentarios

La función _strupr convierte, en su sitio, cada minúscula de str en mayúscula. El valor de la categoría LC_CTYPE de la configuración regional determina la conversión. Otros caracteres no se ven afectados. Para más información sobre LC_CTYPE, consulte 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 Locale.

_wcsupr y _mbsupr son versiones de caracteres anchos y multibyte de _strupr. El argumento y el valor devuelto de son cadenas de _wcsupr caracteres anchos. El argumento y el valor devuelto de son cadenas de _mbsupr caracteres multibyte. Estas tres funciones se comportan exactamente igual.

Si str es un puntero nulo, 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, estas funciones devuelven la cadena original y establecen errno en EINVAL.

En C++, estas funciones tienen sobrecargas de plantilla que invocan los homólogos seguros más recientes de estas funciones. Para obtener más información, consulte Sobrecargas de plantillas seguras.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

Requisitos

Routine	Encabezado necesario
_strupr, _strupr_l	<string.h>
_wcsupr, _wcsupr_l	<string.h> o <wchar.h>
_mbsupr, _mbsupr_l	<mbstring.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

Vea el ejemplo de _strlwr.

Consulte también

Configuración regional
Manipulación de cadenas
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l