man3/iswgraph.3

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