iswctype, iswctype_l or is_wctype Subroutine

Purpose

Determines properties of a wide character.

Library

Standard C Library (libc. a)

Syntax

#include  <wchar.h>

int iswctype  ( WC Property)
wint_t WC;
wctype_t Property;

int iswctype_l  ( WC, Property, Locale)
wint_t WC;
wctype_t Property;
locale_t Locale;

int is_wctype ( WC Property)
wint_t WC;
wctype_t Property;

Description

The iswctype, and iswctype_l subroutines test the wide character specified by the WC parameter to determine if it has the property specified by the Property parameter. The iswctype, and iswctype_l subroutines are defined for the wide-character null value and for values in the character range of the current code set, defined in the current locale or in the locale represented by Locale. The is_wctype subroutine is identical to the iswctype subroutine.

The iswctype subroutine adheres to X/Open Portability Guide Issue 5.

Parameters

Item Description
WC Specifies the wide character to be tested.
Property Specifies the property for which to test.
Locale Specifies the locale, in which the character is tested.

Return Values

If the WC parameter has the property specified by the Property parameter, the iswctype, and iswctype_l subroutines return a nonzero value. If the value specified by the WC parameter does not have the property specified by the Property parameter, the iswctype, and iswctype_l subroutines return a value of zero. If the value specified by the WC parameter is not in the subroutine's domain, the result is undefined. If the value specified by the Property parameter is not valid (that is, not obtained by a call to the wctype subroutine, or the Property parameter has been invalidated by a subsequent call to the setlocale subroutine that has affected the LC_CTYPE category), the result is undefined.