_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr
Cambia la cadena a mayúsculas. Hay disponibles versiones más seguras de estas funciones; vea _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 con /ZW.
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 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.
_wcsupr y _mbsupr son versiones de caracteres anchos y multibyte de _strupr. El argumento y el valor devuelto de _wcsupr son cadenas de caracteres anchos; los de _mbsupr son cadenas de 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, vea Sobrecargas de plantilla seguras.
Asignaciones de rutina 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
Rutina |
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, vea Compatibilidad.
Ejemplo
Vea el ejemplo de _strlwr.