ISWALPHA(3C)ISWALPHA(3C)NAME
iswalpha, isenglish, isideogram, isnumber, isphonogram, isspecial,
iswalnum, iswascii, iswblank, iswcntrl, iswdigit, iswgraph, iswlower,
iswprint, iswpunct, iswspace, iswupper, iswxdigit - wide-character code
classification functions
SYNOPSIS
#include <wchar.h>
#include <wctype.h>
int iswalpha(wint_t wc);
int isenglish(wint_t wc);
int isideogram(wint_t wc);
int isnumber(wint_t wc);
int isphonogram(wint_t wc);
int isspecial(wint_t wc);
int iswalnum(wint_t wc);
int iswascii(wint_t wc);
int iswblank(wint_t wc);
int iswcntrl(wint_t wc);
int iswdigit(wint_t wc);
int iswgraph(wint_t wc);
int iswlower(wint_t wc);
int iswprint(wint_t wc);
int iswpunct(wint_t wc);
int iswspace(wint_t wc);
int iswupper(wint_t wc);
int iswxdigit(wint_t wc);
DESCRIPTION
These functions test whether wc is a wide-character code representing a
character of a particular class defined in the LC_CTYPE category of the
current locale.
In all cases, wc is a wint_t, the value of which must be a wide-charac‐
ter code corresponding to a valid character in the current locale or
must equal the value of the macro WEOF. If the argument has any other
values, the behavior is undefined.
iswalpha(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "alpha" in the program's
current locale.
isenglish(wc)
Tests whether wc is a wide-character code represent‐
ing an English language character, excluding ASCII
characters.
isideogram(wc)
Tests whether wc is a wide-character code represent‐
ing an ideographic language character, excluding
ASCII characters.
isnumber(wc)
Tests whether wc is a wide-character code represent‐
ing digit [0−9], excluding ASCII characters.
isphonogram(wc)
Tests whether wc is a wide-character code represent‐
ing a phonetic language character, excluding ASCII
characters.
isspecial(wc)
Tests whether wc is a wide-character code represent‐
ing a special language character, excluding ASCII
characters.
iswalnum(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "alpha" or "digit" in the
program's current locale.
iswascii(wc)
Tests whether wc is a wide-character code represent‐
ing an ASCII character.
iswblank(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "blank" in the program's
current locale. This function is not available to
applications conforming to standards prior to SUSv3.
See standards(5).
iswlower(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "lower" in the program's
current locale.
iswcntrl(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "cntrl" in the program's
current locale.
iswdigit(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "digit" in the program's
current locale.
iswgraph(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "graph" in the program's
current locale.
iswprint(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "print" in the program's
current locale.
iswpunct(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "punct" in the program's
current locale.
iswspace(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "space" in the program's
current locale.
iswupper(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "upper" in the program's
current locale.
iswxdigit(wc)
Tests whether wc is a wide-character code represent‐
ing a character of class "xdigit" in the program's
current locale.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────────────┐
│ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────────────┤
│CSI │ Enabled │
├────────────────────┼─────────────────────────┤
│Interface Stability │ See below. │
├────────────────────┼─────────────────────────┤
│MT-Level │ MT-Safe with exceptions │
└────────────────────┴─────────────────────────┘
The iswalpha(), iswalnum(), iswblank(), iswcntrl(), iswdigit(), isw‐
graph(), iswlower(), iswprint(), iswpunct(), iswspace(), iswupper(),
and iswxdigit() functions are Standard.
SEE ALSOlocaledef(1), setlocale(3C), stdio(3C), ascii(5), attributes(5), stan‐
dards(5)
Apr 19, 2004 ISWALPHA(3C)
