man3/iswxdigit.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 iswxdigit 3 (date) "Linux man-pages (unreleased)"
  13 .SH NAME
  14 iswxdigit \- test for hexadecimal digit wide character
  15 .SH LIBRARY
  16 Standard C library
  17 .RI ( libc ", " \-lc )
  18 .SH SYNOPSIS
  19 .nf
  20 .B #include <wctype.h>
  21 .P
  22 .BI "int iswxdigit(wint_t " wc );
  23 .fi
  24 .SH DESCRIPTION
  25 The
  26 .BR iswxdigit ()
  27 function is the wide-character equivalent of the
  28 .BR isxdigit (3)
  29 function.
  30 It tests whether
  31 .I wc
  32 is a wide character
  33 belonging to the wide-character class "xdigit".
  34 .P
  35 The wide-character class "xdigit" is a subclass of the wide-character class
  36 "alnum", and therefore also a subclass of the wide-character class "graph" and
  37 of the wide-character class "print".
  38 .P
  39 Being a subclass of the wide-character class "print", the wide-character class
  40 "xdigit" is disjoint from the wide-character class "cntrl".
  41 .P
  42 Being a subclass of the wide-character class "graph", the wide-character class
  43 "xdigit" is disjoint from the wide-character class "space" and its subclass
  44 "blank".
  45 .P
  46 Being a subclass of the wide-character class "alnum", the wide-character class
  47 "xdigit" is disjoint from the wide-character class "punct".
  48 .P
  49 The wide-character class "xdigit" always contains at least the
  50 letters \[aq]A\[aq] to \[aq]F\[aq], \[aq]a\[aq] to \[aq]f\[aq]
  51 and the digits \[aq]0\[aq] to \[aq]9\[aq].
  52 .SH RETURN VALUE
  53 The
  54 .BR iswxdigit ()
  55 function returns nonzero if
  56 .I wc
  57 is a wide character
  58 belonging to the wide-character class "xdigit".
  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 .TS
  64 allbox;
  65 lbx lb lb
  66 l l l.
  67 Interface       Attribute       Value
  68 T{
  69 .na
  70 .nh
  71 .BR iswxdigit ()
  72 T}      Thread safety   MT-Safe locale
  73 .TE
  74 .SH STANDARDS
  75 C11, POSIX.1-2008.
  76 .SH HISTORY
  77 POSIX.1-2001, C99.
  78 .SH NOTES
  79 The behavior of
  80 .BR iswxdigit ()
  81 depends on the
  82 .B LC_CTYPE
  83 category of the
  84 current locale.
  85 .SH SEE ALSO
  86 .BR iswctype (3),
  87 .BR isxdigit (3)