toupper, _toupper, towupper, _toupper_l, _towupper_l

Artículo
04/10/2013

Carácter de convertido 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 a utilizar.

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 la configuración regional.Únicamente caracteres pertinentes para la configuración regional actual se cambian en caso de que.Las funciones sin el sufijo de _lutilizan la configuración regional actualmente establecido.Las versiones de estas funciones con el sufijo de _ltoman 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 la rutina de texto genérico

rutina de TCHAR.H	_UNICODE y _MBCS no definido	_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ñados llamar directamente.Se proporcionan para uso interno por _totupper_l.