Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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	white-
       space 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 <iostream>
	#include <clocale>
	#include <cwctype>
	void try_with(wchar_t c, const char* loc)
	{
	    std::setlocale(LC_ALL, loc);
	    std::wcout	<< "isspace('" << c << "') in "	<< loc << " locale re-
       turned "
		       << std::boolalpha << (bool)std::iswspace(c) << '\n';
	}
	int main()
	{
	    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	white-
       space by	a locale
			       (function template)
	  isspace	       checks if a character is	a space	character
			       (function)

		 ASCII values		   characters	 iscntrl  isprint  is-
       space   isblank	 isgraph   ispunct  isalnum  isalpha  isupper  islower
       isdigit	isxdigit
	decimal	  hexadecimal	  octal			    iswcntrl  iswprint
       iswspace	iswblank iswgraph iswpunct iswalnum iswalpha iswupper iswlower
       iswdigit	 iswxdigit  08	    \x0\x8   \0\10    control codes    0     0
       0	 0	   0	     0	       0	 0	   0	     0
       0	0
					 (NUL,	   etc.)      9		   \x9
       \11	   tab (\t)	    0	  0	    0	    0	   0	     0
       0	0	 0	  0	   0	    0
					 whitespaces  1013    \xA\xD	\12\15
       (\n, \v,	\f,	0     0		0      0	 0	   0	     0
       0	0	 0	  0	   0
					 \r)  1431   \xE\x1F  \16\37   control
       codes	0     0	       0	0	 0	  0	   0	     0
       0	 0	   0	     0 32	 \x20	     \40	 space
       0	 0	0      0     0	       0	 0	   0	     0
       0	  0	     0	3347	\x21\x2F  \41\57    !"#$%&'()*+,-./  0
       0     0	      0		0	0      0	 0	   0	     0
       0	 0  4857   \x30\x39 \60\71   0123456789	     0	       0     0
       0	 0     0	 0     0	0	  0	     0	     0
       5864    \x3A\x40	 \72\100   :;<=>?@	    0	      0	    0	     0
       0      0	     0	       0	 0	   0	     0	       0  6570
       \x41\x46	 \101\106 ABCDEF	  0	    0	  0	   0	     0
       0	 0	0      0      0		0	   0  7190    \x47\x5A
       \107\132	 GHIJKLMNOP	  0	     0	    0	     0	       0     0
       0      0	     0	   0	    0	     0
					 QRSTUVWXYZ 9196    \x5B\x60  \133\140
       [\]^_`		0	   0	  0	    0	       0       0     0
       0	0	 0	  0	   0 97102  \x61\x66  \141\146	abcdef
       0	  0	 0	   0	      0	     0		0      0     0
       0     0	       0 103122	\x67\x7A \147\172 ghijklmnop	  0	     0
       0	 0	    0	   0	      0	      0	     0	       0     0
       0
					 qrstuvwxyz 123126  \x7B\x7E  \172\176
       {|}~		0	   0	  0	    0	       0       0     0
       0	 0	   0	     0	       0  127	     \x7F	  \177
       backspace	 0	0	 0	  0	   0	    0	     0
       0	0	 0	  0	   0
					 character (DEL)

http://cppreference.com		  2022.07.31		      std::iswspace(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::iswspace&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help