From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/string%2Fwide%2Ftowlower.html | 39 +++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 devdocs/c/string%2Fwide%2Ftowlower.html (limited to 'devdocs/c/string%2Fwide%2Ftowlower.html') diff --git a/devdocs/c/string%2Fwide%2Ftowlower.html b/devdocs/c/string%2Fwide%2Ftowlower.html new file mode 100644 index 00000000..0d1bdad4 --- /dev/null +++ b/devdocs/c/string%2Fwide%2Ftowlower.html @@ -0,0 +1,39 @@ +

towlower

Defined in header <wctype.h> 
wint_t towlower( wint_t wc );
+		 (since C95)

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

#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

See also

+ + +
+
(C95)
 converts a wide character to uppercase
(function)
converts a character to lowercase
(function)
C++ documentation for towlower
+

+ © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
+ https://en.cppreference.com/w/c/string/wide/towlower +

+
-- cgit v1.2.3