iswblank(), iswblank_l()

space or tab character test 

Function

SYNOPSIS

#include <wctype.h>

int iswblank(wint_t c);

int iswblank_l(wint_t c, locale_t locale);

DESCRIPTION

The iswblank() and iswblank_l() function tests for a space or tab character. For any locale, this includes the following standard characters:

L'\t' L' '

In the "C" locale, a successful iswblank() test is limited to these characters only. The value of the argument must be representable as an wchar_t or the value of WEOF.

The iswblank_l() function takes an explicit locale argument, whereas the iswblank() function uses the current global or per-thread locale.

The behavior of the iswblank() function is affected by the current locale. To modify the behavior, change the LC_CTYPE category in setlocale(), that is, setlocale(LC_CTYPE, newlocale).

iswblank_l() behaves in the same way as iswblank() 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

c 

Is an integer whose value is representable as a wchar_t, 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 iswblank() and iswblank_l() functions return non-zero for true and zero for false. If the parameter is not in the domain of the function or locale is invalid, the return result is undefined.

CONFORMANCE

iswblank() conforms to ANSI/ISO 9899:1999 'ISO C99'.

iswblank_l() conforms to IEEE Std 1003.1-2008 'POSIX.1'.

MULTITHREAD SAFETY LEVEL

MT-Safe, with exceptions.

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

The function iswblank_l() is MT-Safe as long as no thread calls freelocale() on locale while 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(), iswascii(), iswascii_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.5 Documentation Build 40.