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

NAME
     std::iswspace - std::iswspace

Synopsis
	Defined in header <cwctype>
	int iswspace( wint_t ch );

	Checks	if  the  given	wide character is a wide whitespace character as
     classified by
	the currently installed C locale. In the default locale, the  whitespace
     characters
	are the following:

	  * Space (0x20, ' ')
	  * Form feed (0x0c, '\f')
	  * Line feed (0x0a, '\n')
	  * Carriage return (0x0d, '\r')
	  * Horizontal tab (0x09, '\t')
	  * Vertical tab (0x0b, '\v').

	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  whitespace	character,  zero
     otherwise.

Notes
	ISO   30112   defines  POSIX  space  characters  as  Unicode  characters
     U+0009..U+000D,
	U+0020, U+1680, U+180E, U+2000..U+2006, U+2008..U+200A, U+2028,  U+2029,
     U+205F, and
	U+3000.

Example
	Demonstrates the use of iswspace with different locales.

     // Run this code

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

      void try_with(wchar_t c, const char* loc)
      {
	  std::setlocale(LC_ALL, loc);
	  std::wcout << "isspace('" << c << "') in " << loc << " locale returned
     "
		     << std::boolalpha << static_cast<bool>(std::iswspace(c)) <<
     '\n';
      }

      int main()
      {
	  const wchar_t EM_SPACE = L'\u2003'; // Unicode character 'EM SPACE'
	  try_with(EM_SPACE, "C");
	  try_with(EM_SPACE, "en_US.UTF8");
      }

Output:
      isspace(' ') in C locale returned false
      isspace(' ') in en_US.UTF8 locale returned true

See also
	isspace(std::locale)  checks  if a character is classified as whitespace
     by a locale
			     (function template)
	isspace 	     checks if a character is a space character
			     (function)
	C documentation for
	iswspace

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

home | help