xref: /illumos-gate/usr/src/man/man3c/towlower.3c (revision bbf21555)
te

This file and its contents are supplied under the terms of the
Common Development and Distribution License ("CDDL"), version 1.0.
You may only use this file in accordance with the terms of version
1.0 of the CDDL.

A full copy of the text of the CDDL should have accompanied this
source. A copy of the CDDL is also available via the Internet at
http://www.illumos.org/license/CDDL.


Copyright (c) 2014 Joyent, Inc. All rights reserved.
Copyright 2014 Garrett D'Amore <garrett@damore.org>

TOWLOWER 3C "Jun 21, 2014"
NAME
towlower, towlower_l - transliterate upper-case wide characters to lower-case
SYNOPSIS

#include <wctype.h>

wint_t towlower(wint_t wc);

wint_t towlower_l(wint_t wc, locale_t loc);
DESCRIPTION
The function towlower() is the wide character equivalent of the function tolower (3C). It converts the upper-case wide character wc to the equivalent lower-case wide character, if one exists. If one does not exist, it returns wc unchanged.

The function towlower_l() is equivalent to the function towlower() , but instead of operating in the current locale, operates in the locale specified by loc .

RETURN VALUES
On successful completion, towlower() and towlower_l() return the lower-case character that corresponds to the argument passed. Otherwise, they return the argument unchanged.
ERRORS
No errors are defined.
ATTRIBUTES
ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Standard
MT-Level MT-Safe
SEE ALSO
newlocale (3C), setlocale (3C), towupper (3C), uselocale (3C), locale (7)