toupper, _toupper, towupper, _toupper_l, _towupper_l

Artículo
06/09/2015

Convierta el carácter a mayúsculas.

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 por el que iswlower es distinto de cero y hay un carácter ancho correspondiente que iswupper es distinto de cero, towupper devuelve el carácter ancho correspondiente; si no, towupper devuelve c sin modificar.

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

Para que toupper dé los resultados esperados, __isascii y islower debe ambos devuelven cero.

Comentarios

Cada una de estas rutinas convierte una minúscula especificada a una letra mayúscula si es posible y adecuado. La conversión del caso de towupper es configuración regional- concreta. Únicamente caracteres pertinentes para la configuración regional actual se cambian en caso de que. Las funciones sin el sufijo de _l utilizan la configuración regional actualmente establecido. Las versiones de estas funciones con el sufijo de _l toman la configuración regional como parámetro y utilizan que en lugar de la configuración regional actualmente establecido. Para obtener más información, vea Configuración regional.

Para que toupper dé los resultados esperados, __isascii y isupper debe ambos devuelven cero.

Rutinas de conversión de datos

Asignaciones de rutina 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.