toupper, _toupper, towupper, _toupper_l, _towupper_l

Convierte caracteres a mayúsculas.

Sintaxis

int toupper(
   int c
);
int _toupper(
   int c
);
int towupper(
   wint_t c
);
int _toupper_l(
   int c ,
   _locale_t locale
);
int _towupper_l(
   wint_t c ,
   _locale_t locale
);

Parámetros

c
Carácter que se va a convertir.

locale
Configuración regional que se va a usar.

Valor devuelto

Cada una de estas rutinas convierte una copia de c, si es posible, y devuelve el resultado.

Si c es un carácter ancho para el que iswlower es distinto de cero y hay un carácter ancho correspondiente para el que iswupper es distinto de cero, towupper devuelve el carácter ancho correspondiente; en caso contrario, towupper devuelve c sin cambios.

No hay reservado ningún valor devuelto para indicar un error.

Comentarios

Cada una de estas rutinas convierte una determinada letra minúscula en una letra mayúscula si es posible y pertinente. La conversión de mayúsculas y minúsculas de towupper es específica de la configuración regional. Solo se convierten los caracteres pertinentes para la configuración regional actual. Las funciones que no tienen el sufijo _l usan la configuración regional establecida en ese momento. Las versiones de estas funciones con el sufijo _l toman la configuración regional como un parámetro y lo usan en lugar de la configuración regional establecida en ese momento. Para obtener más información, vea Locale.

Para toupper que proporcione los resultados esperados, __isascii debe devolver un valor distinto de cero.

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
_totupper	toupper	_mbctoupper	towupper
_totupper_l	_toupper_l	_mbctoupper_l	_towupper_l

Nota:

_toupper_l y _towupper_l no dependen de la configuración regional y no están diseñadas para llamarlas directamente. Se proporcionan solo para el uso interno por parte de _totupper_l.

Requisitos

Routine	Encabezado necesario
toupper	<ctype.h>
_toupper	<ctype.h>
towupper	<ctype.h> o <wchar.h>

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

Ejemplo

Consulte el ejemplo en las funciones to.

Consulte también

is, isw rutinas
Funciones to
Configuración regional
Interpretación de secuencias de caracteres de varios bytes