towlower, or towlower_l Subroutine

Purpose

Converts an uppercase wide character to a lowercase wide character.

Library

Standard C Library (libc.a)

Syntax

#include  <wchar.h>

wint_t towlower ( WC) wint_t WC;

wint_t towlower_l( WC,Locale) wint_t WC; locale_t Locale;

Description

The towlower subroutine converts the uppercase wide character specified by the WC parameter into the corresponding lowercase wide character. The LC_CTYPE category affects the behavior of the towlower subroutine.

The towlower_l subroutine is same as the towlower routine, except that the locale data used is from the locale represented by Locale.

Parameters

Item Description
WC Specifies the wide character to convert to lowercase.
Locale Specifies the locale in which character has to be converted.

Return Values

If the WC parameter contains an uppercase wide character that has a corresponding lowercase wide character, that wide character is returned. Otherwise, the WC parameter is returned unchanged.