manual/LDP_man-pages/original/man3/iswspace.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" References consulted:
   9 .\"   GNU glibc-2 source code and manual
  10 .\"   Dinkumware C library reference http://www.dinkumware.com/
  11 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
  12 .\"   ISO/IEC 9899:1999
  13 .\"
  14 .TH ISWSPACE 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  15 .SH NAME
  16 iswspace \- test for whitespace wide character
  17 .SH SYNOPSIS
  18 .nf
  19 .B #include <wctype.h>
  20 .sp
  21 .BI "int iswspace(wint_t " wc );
  22 .fi
  23 .SH DESCRIPTION
  24 The
  25 .BR iswspace ()
  26 function is the wide-character equivalent of the
  27 .BR isspace (3)
  28 function.
  29 It tests whether \fIwc\fP is a wide character
  30 belonging to the wide-character class "space".
  31 .PP
  32 The wide-character class "space" is disjoint from the wide-character class
  33 "graph" and therefore also disjoint from its subclasses "alnum", "alpha",
  34 "upper", "lower", "digit", "xdigit", "punct".
  35 .\" Note: UNIX98 (susv2/xbd/locale.html) says that "space" and "graph" may
  36 .\" have characters in common, except U+0020. But C99 (ISO/IEC 9899:1999
  37 .\" section 7.25.2.1.10) says that "space" and "graph" are disjoint.
  38 .PP
  39 The wide-character class "space" contains the wide-character class "blank".
  40 .PP
  41 The wide-character class "space" always contains at least the space character
  42 and the control
  43 characters \(aq\\f\(aq, \(aq\\n\(aq, \(aq\\r\(aq, \(aq\\t\(aq, \(aq\\v\(aq.
  44 .SH "RETURN VALUE"
  45 The
  46 .BR iswspace ()
  47 function returns nonzero if \fIwc\fP is a wide character
  48 belonging to the wide-character class "space".
  49 Otherwise it returns zero.
  50 .SH "CONFORMING TO"
  51 C99.
  52 .SH NOTES
  53 The behavior of
  54 .BR iswspace ()
  55 depends on the
  56 .B LC_CTYPE
  57 category of the
  58 current locale.
  59 .SH "SEE ALSO"
  60 .BR isspace (3),
  61 .BR iswctype (3)