towlower(3C) Standard C Library Functions towlower(3C)NAMEtowlower - transliterate upper-case wide-character code to lower-case
SYNOPSIS
#include <wchar.h>
wint_t towlower(wint_t wc);
DESCRIPTION
The towlower() function has as a domain a type wint_t, the value of
which must be a character representable as a wchar_t, and must be a
wide-character code corresponding to a valid character in the current
locale or the value of WEOF. If the argument has any other value, the
argument is returned unchanged. If the argument of towlower() repre‐
sents an upper-case wide-character code, and there exists a correspond‐
ing lower-case wide-character code (as defined by character type infor‐
mation in the program locale category LC_CTYPE), the result is the
corresponding lower-case wide-character code. All other arguments in
the domain are returned unchanged.
RETURN VALUES
On successful completion, towlower() returns the lower-case letter cor‐
responding to the argument passed. Otherwise, it returns the argument
unchanged.
ERRORS
No errors are defined.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│CSI │Enabled │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Standard │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOiswalpha(3C), setlocale(3C), towupper(3C), attributes(5), standards(5)SunOS 5.10 14 Aug 2002 towlower(3C)