home | help
std::iswupper(3)	       C++ Standard Libary		std::iswupper(3)

NAME
     std::iswupper - std::iswupper

Synopsis
	Defined in header <cwctype>
	int iswupper( std::wint_t ch );

	Checks if the given wide character is an uppercase letter, i.e. one of
	ABCDEFGHIJKLMNOPQRSTUVWXYZ  or any uppercase letter specific to the cur-
     rent locale.

	If the value of ch is neither representable as a wchar_t  nor  equal  to
     the value of
	the macro WEOF, the behavior is undefined.

Parameters
	ch - wide character

Return value
	Non-zero value if the wide character is an uppercase letter, zero other-
     wise.

Notes
	ISO  30112 specifies which Unicode characters are include in POSIX upper
     category.

Example
     // Run this code

      #include <clocale>
      #include <cwctype>
      #include <iostream>

      int main()
      {
	  const wchar_t c = L'\u053d'; // Armenian capital letter xeh ('O1/2')

	  std::cout << std::hex << std::showbase << std::boolalpha;
	  std::cout << "in the default locale, iswupper("
		    << static_cast<std::wint_t>(c) << ") = "
		    << static_cast<bool>(std::iswupper(c)) << '\n';

	  std::setlocale(LC_ALL, "en_US.utf8");
	  std::cout << "in Unicode locale, iswupper("
		    << static_cast<std::wint_t>(c) << ") = "
		    << static_cast<bool>(std::iswupper(c)) << '\n';
      }

Output:
      in the default locale, iswupper(0x53d) = false
      in Unicode locale, iswupper(0x53d) = true

See also
	isupper(std::locale) checks if a character is classified as uppercase by
     a locale
			     (function template)
	isupper 	     checks if a character is an uppercase character
			     (function)
	C documentation for
	iswupper

	     ASCII values	      characters     iscntrl   isprint	 isspace
     isblank   isgraph	 ispunct   isalnum   isalpha   isupper	islower  isdigit
     isxdigit decimal hexadecimal    octal		      iswcntrl	iswprint
     iswspace  iswblank  iswgraph  iswpunct  iswalnum iswalpha iswupper iswlower
     iswdigit iswxdigit  0a8	  \x0a\x8      \0a\10	  control  codes    a  0
     0	       0	 0	  0	   0	    0	     0	      0        0
     0	      0
				   (NUL,   etc.)    9	      \x9	     \11
     tab  (\t)	      a 0	0	 a 0	   a 0	     0	      0        0
     0	      0        0	0	 0
				   whitespaces	 10a13	   \xAa\xD	 \12a\15
     (\n,  \v,	\f,    a 0	 0	  a 0	    0	     0	      0        0
     0	      0        0	0	 0
				   \r)	14a31	 \xEa\x1F     \16a\37	 control
     codes    a  0	 0	  0	   0	    0	     0	      0        0
     0	       0	 0	   0   32	 \x20	       \40	   space
     0	       a  0	   a  0        a  0	   0	     0	      0        0
     0	      0        0	0 33a47   \x21a\x2F   \41a\57	 !"#$%&'()*+,-./
     0	       a  0	   0	     0	       a  0	   a  0       0        0
     0	      0 	0	  0  48a57    \x30a\x39    \60a\71    0123456789
     0	       a  0	   0	     0	       a  0	   0	     a 0       0
     0	      0        a 0	  a  0	58a64	 \x3Aa\x40    \72a\100	 :;<=>?@
     0	       a  0	   0	     0	       a  0	   a  0       0        0
     0	       0	 0	   0  65a70	\x41a\x46     \101a\106   ABCDEF
     0	       a  0	   0	     0	       a  0	  0	   a 0	     a 0
     a 0       0	0	 a 0 71a90    \x47a\x5A    \107a\132  GHIJKLMNOP
     0	       a  0	   0	     0	       a  0	  0	   a 0	     a 0
     a 0       0	0	 0
				   QRSTUVWXYZ  91a96	 \x5Ba\x60     \133a\140
     [\]^_`	      0        a 0	 0	  0	   a 0	     a 0       0
     0	      0        0	0	 0 97a102  \x61a\x66   \141a\146  abcdef
     0	       a  0	   0	     0	       a  0	  0	   a 0	     a 0
     0	      a 0	0	 a 0 103a122  \x67a\x7A    \147a\172  ghijklmnop
     0	       a  0	   0	     0	       a  0	  0	   a 0	     a 0
     0	      a 0	0	 0
				   qrstuvwxyz 123a126 \x7Ba\x7E   \172a\176 {|}~
     0	      a 0	 0	   0	     a	0	 a  0	     0	       0
     0	       0	 0	   0  127      \x7F	    \177       backspace
     a 0       0	0	 0	  0	   0	    0	     0	       0
     0	      0        0
				   character (DEL)

http://cppreference.com 	   2024.06.10			std::iswupper(3)

home | help