toupper()

convert lowercase character to uppercase 

Function

SYNOPSIS

#include <ctype.h>

int toupper(int c);

int toupper_l(int c, locale_t locale);

DESCRIPTION

The toupper() and toupper_l() function converts a lowercase letter to the corresponding uppercase letter.

PARAMETERS

c 

An integer, the value of which is representable as an unsigned char, or the value of the macro EOF.

locale 

Is a locale_t perhaps returned by newlocale() or LC_GLOBAL_LOCALE or 0 for the current thread locale set with uselocale().

RETURN VALUES

If the parameter is a character for which islower() (or isupper_l()) is true and there is a corresponding character for which isupper() (or isupper_l()) is true, the toupper() (and toupper_l()) function returns the corresponding character. Otherwise, the parameter is returned unchanged.

CONFORMANCE

isupper() conforms to ANSI/ISO 9899-1990.

MULTITHREAD SAFETY LEVEL

MT-Safe, with exceptions.

The function isupper() is MT-Safe as long as no thread calls setlocale() while this function is executing.

The function isupper_l() is MT-Safe as long as no thread calls freelocale() on locale while this function is executing.

PORTING ISSUES

None.

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
_tolower(), _toupper(), isascii(), islower(), islower_l(), isupper(), isupper_l(), newlocale(), setlocale(), tolower(), tolower_l()

PTC MKS Toolkit 10.5 Documentation Build 40.