man3/iswdigit.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 ISWDIGIT 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  15 .SH NAME
  16 iswdigit \- test for decimal digit wide character
  17 .SH SYNOPSIS
  18 .nf
  19 .B #include <wctype.h>
  20 .sp
  21 .BI "int iswdigit(wint_t " wc );
  22 .fi
  23 .SH DESCRIPTION
  24 The
  25 .BR iswdigit ()
  26 function is the wide-character equivalent of the
  27 .BR isdigit (3)
  28 function.
  29 It tests whether \fIwc\fP is a wide character
  30 belonging to the wide-character class "digit".
  31 .PP
  32 The wide-character class "digit" is a subclass of the wide-character class
  33 "xdigit", and therefore also a subclass
  34 of the wide-character class "alnum", of
  35 the wide-character class "graph" and of the wide-character class "print".
  36 .PP
  37 Being a subclass of the wide character
  38 class "print", the wide-character class
  39 "digit" is disjoint from the wide-character class "cntrl".
  40 .PP
  41 Being a subclass of the wide-character class "graph",
  42 the wide-character class
  43 "digit" is disjoint from the wide-character class "space" and its subclass
  44 "blank".
  45 .PP
  46 Being a subclass of the wide-character
  47 class "alnum", the wide-character class
  48 "digit" is disjoint from the wide-character class "punct".
  49 .PP
  50 The wide-character class "digit" is
  51 disjoint from the wide-character class
  52 "alpha" and therefore also disjoint from its subclasses "lower", "upper".
  53 .PP
  54 The wide-character class "digit" always
  55 contains exactly the digits '0' to '9'.
  56 .SH "RETURN VALUE"
  57 The
  58 .BR iswdigit ()
  59 function returns non-zero
  60 if \fIwc\fP is a wide character
  61 belonging to the wide-character class "digit".
  62 Otherwise it returns zero.
  63 .SH "CONFORMING TO"
  64 C99.
  65 .SH NOTES
  66 The behaviour of
  67 .BR iswdigit ()
  68 depends on the LC_CTYPE category of the
  69 current locale.
  70 .SH "SEE ALSO"
  71 .BR isdigit (3),
  72 .BR iswctype (3)