Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

Guardian Native C Library Calls (t - z) wctype(3)
NAME
wctype - Gets a handle to classify wide characters
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
SYNOPSIS
#include <wchar.h>
wctype_t wctype(
char *property);
PARAMETERS
property Points to a string that identifies a character class.
DESCRIPTION
The wctype() function obtains a handle for valid property names for wide characters, as defined
in the current locale. The handle is of data type wctype_t, and it can be used as the wc_prop
parameter in the iswctype() function to check whether a wide character belongs to this class (see
the iswctype() reference page).
Values returned by the wctype( ) function are valid until the setlocale() function modifies the
value of the LC_CTYPE environment variable. The property parameter can have a value equal
to one of the basic character classes or to a character class that is defined for a customized locale.
The characters included in each class are specified in the locale definition file (see the localedef
command and the locale file format reference pages for more information).
The basic character classes are as follows:
alnum A combination of the classes alpha and digit.
alpha Alphabetic (letter) character. Automatically includes characters in the classes
upper and lower.
blank Blank characters (such as space).
cntrl Control character. No characters in alpha or print are included.
digit Numeric digit character. The following characters are included in this class:
0123456789
graph Graphic character for printing. Does not include the space character or cntrl
characters; includes all characters in alpha, digit, and punct.
lower Lowercase character. No characters in cntrl, digit, punct,orspace are included.
At a minimum, the 26 lowercase US-ASCII characters are included in this class.
These are:
abcdefghijklmnopqrstuvwxyz
print Print character. Includes characters in graph and the space character, but no
characters in cntrl are included.
527192-005 Hewlett-Packard Company 7−91