man3/iswspace.3

   1 '\" t
   2 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   3 .\"
   4 .\" SPDX-License-Identifier: GPL-2.0-or-later
   5 .\"
   6 .\" References consulted:
   7 .\"   GNU glibc-2 source code and manual
   8 .\"   Dinkumware C library reference http://www.dinkumware.com/
   9 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  10 .\"   ISO/IEC 9899:1999
  11 .\"
  12 .TH iswspace 3 (date) "Linux man-pages (unreleased)"
  13 .SH NAME
  14 iswspace \- test for whitespace wide character
  15 .SH LIBRARY
  16 Standard C library
  17 .RI ( libc ", " \-lc )
  18 .SH SYNOPSIS
  19 .nf
  20 .B #include <wctype.h>
  21 .PP
  22 .BI "int iswspace(wint_t " wc );
  23 .fi
  24 .SH DESCRIPTION
  25 The
  26 .BR iswspace ()
  27 function is the wide-character equivalent of the
  28 .BR isspace (3)
  29 function.
  30 It tests whether
  31 .I wc
  32 is a wide character
  33 belonging to the wide-character class "space".
  34 .PP
  35 The wide-character class "space" is disjoint from the wide-character class
  36 "graph" and therefore also disjoint from its subclasses "alnum", "alpha",
  37 "upper", "lower", "digit", "xdigit", "punct".
  38 .\" Note: UNIX98 (susv2/xbd/locale.html) says that "space" and "graph" may
  39 .\" have characters in common, except U+0020. But C99 (ISO/IEC 9899:1999
  40 .\" section 7.25.2.1.10) says that "space" and "graph" are disjoint.
  41 .PP
  42 The wide-character class "space" contains the wide-character class "blank".
  43 .PP
  44 The wide-character class "space"
  45 always contains at least the space character
  46 and the control characters
  47 \[aq]\ef\[aq], \[aq]\en\[aq], \[aq]\er\[aq], \[aq]\et\[aq], and \[aq]\ev\[aq].
  48 .SH RETURN VALUE
  49 The
  50 .BR iswspace ()
  51 function returns nonzero if
  52 .I wc
  53 is a wide character
  54 belonging to the wide-character class "space".
  55 Otherwise, it returns zero.
  56 .SH ATTRIBUTES
  57 For an explanation of the terms used in this section, see
  58 .BR attributes (7).
  59 .ad l
  60 .nh
  61 .TS
  62 allbox;
  63 lbx lb lb
  64 l l l.
  65 Interface       Attribute       Value
  66 T{
  67 .BR iswspace ()
  68 T}      Thread safety   MT-Safe locale
  69 .TE
  70 .hy
  71 .ad
  72 .sp 1
  73 .SH STANDARDS
  74 POSIX.1-2001, POSIX.1-2008, C99.
  75 .SH NOTES
  76 The behavior of
  77 .BR iswspace ()
  78 depends on the
  79 .B LC_CTYPE
  80 category of the
  81 current locale.
  82 .SH SEE ALSO
  83 .BR isspace (3),
  84 .BR iswctype (3)