wctype(3)

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:

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

ctype(3), nextwctype(3), xlocale(3)

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.