[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

iswctype or is_wctype Subroutine

Purpose

Determines properties of a wide character.

Library

Standard C Library (libc. a)

Syntax

#include  <wchar.h>
int iswctype  (WCProperty)
wint_t WC;
wctype_t Property;
int is_wctype (WCProperty)
wint_t WC;
wctype_t Property;

Description

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

Parameters

WC Specifies the wide character to be tested.
Property Specifies the property for which to test.

Return Values

If the WC parameter has the property specified by the Property parameter, the iswctype subroutine returns a nonzero value. If the value specified by the WC parameter does not have the property specified by the Property parameter, the iswctype subroutine returns 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.

Implementation Specifics

These subroutines are part of Base Operating System (BOS) Runtime.

The iswctype subroutine adheres to Systems Interface and Headers, Issue 4 of X/Open.

Related Information

The iswalnum subroutine, iswalpha subroutine, iswcntrl subroutine, iswdigit subroutine, iswgraph subroutine, iswlower subroutine, iswprint subroutine, iswpunct subroutine, iswspace subroutine, iswupper subroutine, iswxdigit subroutine, setlocale subroutine, towlower subroutine, towupper subroutine, wctype subroutine.

National Language Support Overview for Programming, Subroutines Overview, Understanding Wide Character Classification Subroutines in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Contents | Glossary | Home | Search ]