wchar(5)                                                           wchar(5)

NAME
     wchar - wide character types

SYNOPSIS
     #include <wchar.h>

DESCRIPTION
     The <wchar.h> header defines the following data types through typedef:

     wchart     See <stddef.h>.

     wintt      An integral type capable of storing any valid value of
                 wchart, or WEOF.

     wctypet    A scalar type of a data object that can hold values which
                 represent locale-specific character classification.

     mbstatet   An object type other than an array type that can hold the
                 conversion state information necessary to convert between
                 sequences of (possibly multibyte) characters and wide
                 characters. If a code set is being used such that an
                 mbstatet needs to preserve more than 2 levels of reserved
                 state, the results are unspecified.

     FILE        As described in <stdio.h>.

     sizet      As described in <stddef.h>.

     The <wchar.h> header declares the following as functions and may also
     define them as macros.

     Function prototypes must be provided for use with an ISO C compiler.

     wintt  btowc(int);
     int     fwprintf(FILE *, const wchart *, ...);
     int     fwscanf(FILE *, const wchart *, ...);
     int     iswalnum(wintt);
     int     iswalpha(wintt);
     int     iswcntrl(wintt);
     int     iswdigit(wintt);
     int     iswgraph(wintt);
     int     iswlower(wintt);
     int     iswprint(wintt);
     int     iswpunct(wintt);
     int     iswspace(wintt);
     int     iswupper(wintt);
     int     iswxdigit(wintt);
     int     iswctype(wintt, wctypet);
     wintt  fgetwc(FILE *);
     wchart *fgetws(wchart *, int, FILE *);
     wintt  fputwc(wchart, FILE *);
     int     fputws(const wchart *, FILE *);



Page 1                       Reliant UNIX 5.44                Printed 11/98

wchar(5)                                                           wchar(5)

     int     fwide(FILE *, int);
     wintt  getwc(FILE *);
     wintt  getwchar(void);
     sizet  mbsinit(const mbstatet *);
     sizet  mbrlen(const char *, sizet, mbstatet *);
     sizet  mbrtowc(wchart *, const char *, sizet, mbstatet *);
     sizet  mbsrtowcs(wchart *, const char **, sizet, mbstatet *);
     wintt  putwc(wchart, FILE *);
     wintt  putwchar(wchart);
     int     swprintf(wchart *, sizet, const wchart *, ...);
     int     swscanf(const wchart *, const wchart *, ...);
     wintt  towlower(wintt);
     wintt  towupper(wintt);
     wintt  ungetwc(wintt, FILE *);
     int     vfwprintf(FILE *, const wchart *, valist);
     int     vwprintf(const wchart *, valist);
     int     vswprintf(wchart *, sizet, const wchart *, valist);
     sizet  wcrtomb(char *, wchart, mbstatet *);
     wchart *wcscat(wchart *, const wchart *);
     wchart * wcschr(const wchart *, wchart);
     int     wcscmp(const wchart *, const wchart *);
     int     wcscoll(const wchart *, const wchart *);
     wchart *wcscpy(wchart *, const wchart *);
     sizet  wcscspn(const wchart *, const wchart *);
     sizet  wcsftime(wchart *, sizet, const wchart *, const struct tm *);
     sizet  wcslen(const wchart *);
     wchart *wcsncat(wchart *, const wchart *, sizet);
     int     wcsncmp(const wchart *, const wchart *, sizet);
     wchart *wcsncpy(wchart *, const wchart *, sizet);
     wchart *wcspbrk(const wchart *, const wchart *);
     wchart *wcsrchr(const wchart *, wchart);
     sizet  wcsrtombs(char *, const wchart **, sizet, mbstatet *);
     sizet  wcsspn(const wchart *, const wchart *);
     wchart *wcsstr(const wchart *, const wchart *);
     double  wcstod(const wchart *, wchart **);
     wchart *wcstok(wchart *, const wchart *, wchart **);
     long int        wcstol(const wchart *, wchart **, int);
     unsigned long int       wcstoul(const wchart *, wchart **, int);
     wchart *wcswcs(const wchart *, const wchart *);
     int     wcswidth(const wchart *, sizet);
     sizet  wcsxfrm(wchart *, const wchart *, sizet);
     int     wctob(wintt);
     wctypet wctype(const char *);
     int     wcwidth(wchart);
     wchart *wmemchr(const wchart *, wchart, sizet);
     int     wmemcmp(const wchart *, const wchart *, sizet);
     wchart *wmemcpy(wchart *, const wchart *, sizet);
     wchart *wmemmove(wchart *, const wchart *, sizet);
     wchart *wmemset(wchart *, wchart, sizet);
     int     wprintf(const wchart *, ...);
     int     wscanf(const wchart *, ...);



Page 2                       Reliant UNIX 5.44                Printed 11/98

wchar(5)                                                           wchar(5)

     <wchar.h> defines the following macro names:

     WCHARMAX   The maximum value representable by an object of type
                 wchart.

     WCHARMIN   The minimum value representable by an object of type
                 wchart.

     WEOF        Constant expression of type wintt that is returned by
                 several WP functions to indicate end-of-file.

     NULL        As described in <stddef.h>.

     The tag tm is declared as naming an incomplete structure type, the
     contents of which are described in the header <time.h>.

     Inclusion of the <wchar.h> header may make visible all symbols from
     the headers <ctype.h>, <stdio.h>, <stdarg.h>, <stdlib.h>, <string.h>,
     <stddef.h> and <time.h>.

SEE ALSO
     btowc(3C), conv(3C), fwide(3C), mbchar(3C), mbsinit(3C), mbstring(3C),
     memory(3C), towctrans(3C), wctob(3C), wctrans(3C), wctype(3C),
     wstring(3C), wtype(3C), fwprintf(3S), fwscanf(3S), vprintf(3S),
     ctype(5), stdarg(5), stddef(5), stdio(5), stdlib(5), string(5),
     time(5).




























Page 3                       Reliant UNIX 5.44                Printed 11/98