iswascii(), iswscii_l()

tests if wide character is a 7-bit US-ASCII character 

Function

SYNOPSIS

#include <wctype.h>

int iswascii(wint_t wc);

int iswascii_l(wint_t wc, locale_t locale);

DESCRIPTION

The iswascii() function tests whether the specified wide character is a 7-bit US-ASCII character. The behavior of the iswascii() function is not affected by the current locale.

iswascii_l() behaves in the same way as iswascii() without the _l suffix, but uses the specified locale rather than the global or per-thread locale. A locale_t is returned by newlocale().

PARAMETERS

wc 

Is a wide character code corresponding to a valid character in the current locale or the value of the macro WEOF.

locale 

Is a locale_t perhaps returned by newlocale() or LC_GLOBAL_LOCALE or 0 for the current thread locale set with uselocale().

RETURN VALUES

The iswascii() and iswascii_l() functions return non-zero for true and zero for false. If the parameter is not in the domain of the function, the behavior is undefined.

CONFORMANCE

PTC MKS Toolkit UNIX APIs extension.

MULTITHREAD SAFETY LEVEL

MT-Safe, with exceptions.

The function iswascii() is MT-Safe as long as no thread calls setlocale() while this function is executing.

The function iswascii_l() is MT-Safe as long as no thread calls freelocale() on localewhile this function is executing.

PORTING ISSUES

None.

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
iswalnum(), iswalnum_l(), iswalpha(), iswalpha_l(), iswcntrl(), iswcntrl_l(), iswdigit(), iswdigit_l(), iswgraph(), iswgraph_l(), iswlower(), iswlower_l(), iswprint(), iswprint_l(), iswpunct(), iswpunct_l(), iswspace(), iswspace_l(), iswupper(), iswupper_l(), iswxdigit(), iswxdigit_l(), newlocale(), setlocale()

PTC MKS Toolkit 10.4 Documentation Build 39.