towupper(), towupper_l

convert wide character to uppercase 

Function


SYNOPSIS

#include <wctype.h>

wint_t towupper(wint_t wc);

wint_t towupper_l(wint_t wc, locale_t locale);


DESCRIPTION

The towupper() (and towupper_l()) function converts a lowercase letter to the corresponding uppercase letter. The call towupper(wc)is equivalent to:

towctrans(wc, wctrans("toupper"));
towctrans_l(wc, wctrans("toupper"), locale);

PARAMETERS

wc 

Is a wide character code corresponding to a valid character in the current locale or the value of the macro WEOF.

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 wide character for which iswlower() (or iswlower_l()) is true and there is a corresponding wide character for which iswupper() (or iswupper_l()) is true, the towupper() (and towupper_l()) function returns the corresponding wide character. Otherwise, the parameter is returned unchanged.


CONFORMANCE

towupper() conforms to ANSI/ISO 9899-1990/AM 1-1995.


MULTITHREAD SAFETY LEVEL

MT-Safe, with exceptions.

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

The function is towupper_l() 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:
iswlower(), iswlower_l(), iswupper(), iswupper_l(), newlocale(), setlocale(), towctrans(), towctrans_l(), towlower(), towlower_l(), wctrans(), wctrans_l()


PTC MKS Toolkit 10.3 Documentation Build 39.