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%2Ftowupper.html | 35 +++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 devdocs/c/string%2Fwide%2Ftowupper.html (limited to 'devdocs/c/string%2Fwide%2Ftowupper.html') diff --git a/devdocs/c/string%2Fwide%2Ftowupper.html b/devdocs/c/string%2Fwide%2Ftowupper.html new file mode 100644 index 00000000..4e0cdeb3 --- /dev/null +++ b/devdocs/c/string%2Fwide%2Ftowupper.html @@ -0,0 +1,35 @@ +

towupper

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

Converts the given wide character to uppercase, if possible.

+

Parameters

+ +
wc - wide character to be converted

Return value

Uppercase version of wc or unmodified wc if no uppercase version is listed in the current C locale.

+

Notes

Only 1:1 character mapping can be performed by this function, e.g. the uppercase form of 'ß' is (with some exceptions) the two-character string "SS", which cannot be obtained by towupper.

+

ISO 30112 specifies which pairs of Unicode characters are included in this mapping.

+

Example

#include <stdio.h>
+#include <wchar.h>
+#include <wctype.h>
+#include <locale.h>
+ 
+int main(void)
+{
+    wchar_t wc =  L'\u017f'; // Latin small letter Long S ('ſ')
+    printf("in the default locale, towupper(%#x) = %#x\n", wc, towupper(wc));
+    setlocale(LC_ALL, "en_US.utf8");
+    printf("in Unicode locale, towupper(%#x) = %#x\n", wc, towupper(wc));
+}

Output:

+
in the default locale, towupper(0x17f) = 0x17f
+in Unicode locale, towupper(0x17f) = 0x53

References

See also

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

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

+
-- cgit v1.2.3