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  2021-03-22 "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 .RS -4
  27 Feature Test Macro Requirements for glibc (see
  28 .BR feature_test_macros (7)):
  29 .RE
  30 .PP
  31 .BR iswblank ():
  32 .nf
  33     _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
  34 .fi
  35 .SH DESCRIPTION
  36 The
  37 .BR iswblank ()
  38 function is the wide-character equivalent of the
  39 .BR isblank (3)
  40 function.
  41 It tests whether \fIwc\fP is a wide character
  42 belonging to the wide-character class "blank".
  43 .PP
  44 The wide-character class "blank" is a subclass of the wide-character class
  45 "space".
  46 .PP
  47 Being a subclass of the wide-character class "space",
  48 the wide-character class "blank" is disjoint from the
  49 wide-character class "graph" and therefore also disjoint
  50 from its subclasses "alnum", "alpha", "upper", "lower", "digit",
  51 "xdigit", "punct".
  52 .PP
  53 The wide-character class "blank" always contains
  54 at least the space character
  55 and the control character \(aq\et\(aq.
  56 .SH RETURN VALUE
  57 The
  58 .BR iswblank ()
  59 function returns nonzero
  60 if \fIwc\fP is a wide character
  61 belonging to the wide-character class "blank".
  62 Otherwise, it returns zero.
  63 .SH ATTRIBUTES
  64 For an explanation of the terms used in this section, see
  65 .BR attributes (7).
  66 .ad l
  67 .nh
  68 .TS
  69 allbox;
  70 lbx 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 .hy
  78 .ad
  79 .sp 1
  80 .SH CONFORMING TO
  81 POSIX.1-2001, POSIX.1-2008.
  82 .SH NOTES
  83 The behavior of
  84 .BR iswblank ()
  85 depends on the
  86 .B LC_CTYPE
  87 category of the
  88 current locale.
  89 .SH SEE ALSO
  90 .BR isblank (3),
  91 .BR iswctype (3)