iswspace

Defined in header `<wctype.h>`
int iswspace( wint_t ch );		(since C95)

Checks if the given wide character is a whitespace character, i.e. either space (0x20), form feed (0x0c), line feed (0x0a), carriage return (0x0d), horizontal tab (0x09), vertical tab (0x0b) or any whitespace character specific to the current locale.

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

Run this code

#include <stdio.h>
#include <wchar.h>
#include <wctype.h>
#include <locale.h>

int main(void)
{
    wchar_t c = L'\u2003'; // Unicode character 'EM SPACE'
    printf("in the default locale, iswspace(%#x) =%d\n", c, !!iswspace(c));
    setlocale(LC_ALL, "en_US.utf8");
    printf("in Unicode locale, iswspace(%#x) =%d\n", c, !!iswspace(c));
}

Output:

in the default locale, iswspace(0x2003) = 0
in Unicode locale, iswspace(0x2003) = 1

References

C11 standard (ISO/IEC 9899:2011):

7.30.2.1.10 The iswspace function (p: 450-451)

C99 standard (ISO/IEC 9899:1999):

7.25.2.1.10 The iswspace function (p: 396-397)

ASCII values			characters	`iscntrl` `iswcntrl`	`isprint` `iswprint`	`isspace` `iswspace`	`isblank` `iswblank`	`isgraph` `iswgraph`	`ispunct` `iswpunct`	`isalnum` `iswalnum`	`isalpha` `iswalpha`	`isupper` `iswupper`	`islower` `iswlower`	`isdigit` `iswdigit`	`isxdigit` `iswxdigit`
decimal	hexadecimal	octal	characters	`iscntrl` `iswcntrl`	`isprint` `iswprint`	`isspace` `iswspace`	`isblank` `iswblank`	`isgraph` `iswgraph`	`ispunct` `iswpunct`	`isalnum` `iswalnum`	`isalpha` `iswalpha`	`isupper` `iswupper`	`islower` `iswlower`	`isdigit` `iswdigit`	`isxdigit` `iswxdigit`
08	`\x0\x8`	`\0\10`	control codes (`NUL`, etc.)	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
9	`\x9`	`\11`	tab (`\t`)	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
1013	`\xA\xD`	`\12\15`	whitespaces (`\n`, `\v`, `\f`, `\r`)	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
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` `QRSTUVWXYZ`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
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` `qrstuvwxyz`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
123126	`\x7B\x7E`	`\172\176`	`{\|}~`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
127	`\x7F`	`\177`	backspace character (`DEL`)	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`

Language
Headers
Type support
Program utilities
Variadic function support
Error handling
Dynamic memory management
Date and time utilities
Strings library
Algorithms
Numerics
Input/output support
Localization support
Atomic operations (C11)
Thread support (C11)
Technical Specifications