man3/iswalnum.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 iswalnum 3 (date) "Linux man-pages (unreleased)"
  13 .SH NAME
  14 iswalnum \- test for alphanumeric wide character
  15 .SH LIBRARY
  16 Standard C library
  17 .RI ( libc ", " \-lc )
  18 .SH SYNOPSIS
  19 .nf
  20 .B #include <wctype.h>
  21 .PP
  22 .BI "int iswalnum(wint_t " wc );
  23 .fi
  24 .SH DESCRIPTION
  25 The
  26 .BR iswalnum ()
  27 function is the wide-character equivalent of the
  28 .BR isalnum (3)
  29 function.
  30 It tests whether
  31 .I wc
  32 is a wide character
  33 belonging to the wide-character class "alnum".
  34 .PP
  35 The wide-character class "alnum" is a subclass of the wide-character class
  36 "graph", and therefore also a subclass of the wide-character class "print".
  37 .PP
  38 Being a subclass of the wide-character class "print",
  39 the wide-character class
  40 "alnum" is disjoint from the wide-character class "cntrl".
  41 .PP
  42 Being a subclass of the wide-character class "graph",
  43 the wide-character class "alnum" is disjoint from
  44 the wide-character class "space" and its subclass "blank".
  45 .PP
  46 The wide-character class "alnum" is disjoint from the wide-character class
  47 "punct".
  48 .PP
  49 The wide-character class "alnum" is the union of the wide-character classes
  50 "alpha" and "digit".
  51 As such, it also contains the wide-character class
  52 "xdigit".
  53 .PP
  54 The wide-character class "alnum"
  55 always contains at least the letters
  56 \[aq]A\[aq] to \[aq]Z\[aq],
  57 \[aq]a\[aq] to \[aq]z\[aq],
  58 and the digits \[aq]0\[aq] to \[aq]9\[aq].
  59 .SH RETURN VALUE
  60 The
  61 .BR iswalnum ()
  62 function returns nonzero
  63 if
  64 .I wc
  65 is a wide character
  66 belonging to the wide-character class "alnum".
  67 Otherwise, it returns zero.
  68 .SH ATTRIBUTES
  69 For an explanation of the terms used in this section, see
  70 .BR attributes (7).
  71 .ad l
  72 .nh
  73 .TS
  74 allbox;
  75 lbx lb lb
  76 l l l.
  77 Interface       Attribute       Value
  78 T{
  79 .BR iswalnum ()
  80 T}      Thread safety   MT-Safe locale
  81 .TE
  82 .hy
  83 .ad
  84 .sp 1
  85 .SH STANDARDS
  86 POSIX.1-2001, POSIX.1-2008, C99.
  87 .SH NOTES
  88 The behavior of
  89 .BR iswalnum ()
  90 depends on the
  91 .B LC_CTYPE
  92 category of the
  93 current locale.
  94 .SH SEE ALSO
  95 .BR isalnum (3),
  96 .BR iswctype (3)