Query: wctype_l
OS: osx
Section: 3
Links: osx man pages all man pages
Forums: unix linux community forum categories
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
WCTYPE(3) BSD Library Functions Manual WCTYPE(3)NAMEiswctype, iswctype_l, wctype, wctype_l -- wide character class functionsLIBRARYStandard 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);DESCRIPTIONThe 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 print 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 VALUESThe 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().EXAMPLESReimplement iswalpha(3) in terms of iswctype() and wctype(): int myiswalpha(wint_t wc) { return (iswctype(wc, wctype("alpha"))); }SEE ALSOctype(3), xlocale(3)STANDARDSThe iswctype() and wctype() functions conform to IEEE Std 1003.1-2001 (``POSIX.1''). The ``ideogram'', ``phonogram'' ``special'', and ``rune'' character classes are extensions.HISTORYThe iswctype() and wctype() functions first appeared in FreeBSD 5.0.BSDMarch 27, 2004 BSD