man3/iswblank.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" References consulted:
  11 .\"   GNU glibc-2 source code and manual
  12 .\"   Dinkumware C library reference http://www.dinkumware.com/
  13 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  14 .\"   ISO/IEC 9899:1999
  15 .\"
  16 .TH ISWBLANK 3  2016-03-15 "GNU" "Linux Programmer's Manual"
  17 .SH NAME
  18 iswblank \- test for whitespace wide character
  19 .SH SYNOPSIS
  20 .nf
  21 .B #include <wctype.h>
  22 .PP
  23 .BI "int iswblank(wint_t " wc );
  24 .fi
  25 .PP
  26 .in -4n
  27 Feature Test Macro Requirements for glibc (see
  28 .BR feature_test_macros (7)):
  29 .in
  30 .PP
  31 .ad l
  32 .BR iswblank ():
  33 .RS
  34 _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L
  35 .RE
  36 .ad
  37 .SH DESCRIPTION
  38 The
  39 .BR iswblank ()
  40 function is the wide-character equivalent of the
  41 .BR isblank (3)
  42 function.
  43 It tests whether \fIwc\fP is a wide character
  44 belonging to the wide-character class "blank".
  45 .PP
  46 The wide-character class "blank" is a subclass of the wide-character class
  47 "space".
  48 .PP
  49 Being a subclass of the wide-character class "space",
  50 the wide-character class "blank" is disjoint from the
  51 wide-character class "graph" and therefore also disjoint
  52 from its subclasses "alnum", "alpha", "upper", "lower", "digit",
  53 "xdigit", "punct".
  54 .PP
  55 The wide-character class "blank" always contains
  56 at least the space character
  57 and the control character \(aq\\t\(aq.
  58 .SH RETURN VALUE
  59 The
  60 .BR iswblank ()
  61 function returns nonzero
  62 if \fIwc\fP is a wide character
  63 belonging to the wide-character class "blank".
  64 Otherwise, it returns zero.
  65 .SH ATTRIBUTES
  66 For an explanation of the terms used in this section, see
  67 .BR attributes (7).
  68 .TS
  69 allbox;
  70 lb lb lb
  71 l l l.
  72 Interface       Attribute       Value
  73 T{
  74 .BR iswblank ()
  75 T}      Thread safety   MT-Safe locale
  76 .TE
  77 .SH CONFORMING TO
  78 POSIX.1-2001, POSIX.1-2008.
  79 .SH NOTES
  80 The behavior of
  81 .BR iswblank ()
  82 depends on the
  83 .B LC_CTYPE
  84 category of the
  85 current locale.
  86 .SH SEE ALSO
  87 .BR isblank (3),
  88 .BR iswctype (3)