tolower(), tolower_l()

convert uppercase letter to lowercase 

Function

SYNOPSIS

#include <ctype.h>

int tolower(int c);

int tolower_l(int c, locale_t locale);

DESCRIPTION

The tolower() function converts an uppercase letter to the corresponding lowercase 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 isupper() (or isupper_l()) is true and there is a corresponding character for which islower() (or islower_l()) is true, the tolower() (and tolower_l()) function returns the corresponding character. Otherwise, the parameter is returned unchanged.

CONFORMANCE

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

MULTITHREAD SAFETY LEVEL

MT-Safe, with exceptions.

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

This function tolower_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(), islower(), islower_l(), isupper(), isupper_l(), newlocale(), setlocale(), toascii(), toupper(), toupper_l()

PTC MKS Toolkit 10.5 Documentation Build 40.