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

NAME
     std::iswcntrl - std::iswcntrl

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

	Checks	if  the  given wide character is a control character, i.e. codes
     0x00-0x1F and
	0x7F and any control characters specific to the current 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 a control character, zero other-
     wise.

Notes
	ISO  30112  defines  POSIX  control  characters  as  Unicode  characters
     U+0000..U+001F,
	U+007F..U+009F, U+2028, and U+2029 (Unicode classes Cc, Zl, and Zp).

Example
     // Run this code

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

      int main()
      {
	  wchar_t c = L'\u2028'; // the Unicode character "line separator"

	  std::cout << std::hex << std::showbase << std::boolalpha;
	  std::cout << "in the default locale, iswcntrl(" <<  (std::wint_t)c  <<
     ") = "
		    << (bool)std::iswcntrl(c) << '\n';
	  std::setlocale(LC_ALL, "en_US.utf8");
	  std::cout  << "in Unicode locale, iswcntrl(" << (std::wint_t)c << ") =
     "
		    << (bool)std::iswcntrl(c) << '\n';
      }

Output:
      in the default locale, iswcntrl(0x2028) = false
      in Unicode locale, iswcntrl(0x2028) = true

See also
			     checks if a character is classified  as  a  control
     character by a
	iscntrl(std::locale) locale
			     (function template)
	iscntrl 	     checks if a character is a control character
			     (function)
	C documentation for
	iswcntrl

	     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::iswcntrl(3)

home | help