NAME
iswctype,
iswctype_l, wctype,
wctype_l —
wide character class
functions
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include
<wctype.h>
int
iswctype(wint_t wc,
wctype_t charclass);
wctype_t
wctype(const char
*property);
#include
<wctype.h>
#include <xlocale.h>
int
iswctype_l(wint_t wc,
wctype_t charclass, locale_t
loc);
wctype_t
wctype_l(const char *property,
locale_t loc);
DESCRIPTION
The
wctype()
function returns a value of type wctype_t, which
represents the requested wide character class and may be used as the second
argument for calls to iswctype().
The following character class names are recognised:
alnum |
cntrl | ideogram | space | xdigit | |
alpha |
digit | lower | punct | special | |
blank |
graph | phonogram | rune | upper |
The
iswctype()
function checks whether the wide character wc is in
the character class charclass.
Although the
iswctype()
and wctype() functions use the current locale, the
iswctype_l()
and
wctype_l()
functions may be passed locales directly. See
xlocale(3) for more information.
RETURN VALUES
The iswctype() function returns non-zero
if and only if wc has the property described by
charclass, or charclass is
zero.
The wctype() function returns 0 if
property is invalid; otherwise, it returns a value of
type wctype_t that can be used in subsequent calls to
iswctype().
EXAMPLES
Reimplement iswalpha(3) in terms of iswctype()
and wctype():
int
myiswalpha(wint_t wc)
{
return (iswctype(wc, wctype("alpha")));
}
SEE ALSO
STANDARDS
The iswctype() and
wctype() functions conform to IEEE
Std 1003.1-2001 (“POSIX.1”). The
“ideogram”,
“phonogram”,
“special”, and
“rune” character classes are
extensions.
HISTORY
The iswctype() and
wctype() functions first appeared in
FreeBSD 5.0.