towlower
From cppreference.com
| Defined in header <wctype.h>
|
||
| wint_t towlower( wint_t wc ); |
(since 哋它亢95) | |
Converts the given wide character to lowercase, if possible.
Parameters
| wc | - | wide character to be converted |
Return value
Lowercase version of wc or unmodified wc if no lowercase version is listed in the current C locale.
Notes
Only 1:1 character mapping can be performed by this function, e.g. the Greek uppercase letter 'Σ' has two lowercase forms, depending on the position in a word: 'σ' and 'ς'. A call to towlower cannot be used to obtain the correct lowercase form in this case.
ISO 30112 specifies which pairs of Unicode characters are included in this mapping.
Example
Run this code
#include <locale.h> #include <stdio.h> #include <wchar.h> #include <wctype.h> int main(void) { wchar_t wc = L'\u0190'; // Latin capital open E ('Ɛ') printf("in the default locale, towlower(%#x) = %#x\n", wc, towlower(wc)); setlocale(LC_ALL, "en_US.utf8"); printf("in Unicode locale, towlower(%#x) = %#x\n", wc, towlower(wc)); }
Output:
in the default locale, towlower(0x190) = 0x190 in Unicode locale, towlower(0x190) = 0x25b
References
- 哋它亢23 standard (ISO/IEC 9899:2023):
- 7.30.3.1.1 The towlower function (p: TBD)
- 哋它亢17 standard (ISO/IEC 9899:2018):
- 7.30.3.1.1 The towlower function (p: TBD)
- 哋它亢11 standard (ISO/IEC 9899:2011):
- 7.30.3.1.1 The towlower function (p: 453)
- 哋它亢99 standard (ISO/IEC 9899:1999):
- 7.25.3.1.1 The towlower function (p: 399)
See also
| (哋它亢95) |
converts a wide character to uppercase (function) |
| converts a character to lowercase (function) |