wchar(5) wchar(5)
NAME
wchar - extended wide character utilities
SYNOPSIS
#include <wchar.h>
DESCRIPTION
The wchar.h header defines the data types listed below through
typedefs:
wchar_t Integral type whose range of values can represent
distinct wide character codes for all members of
the largest character set specified among the
locales supported by the compilation environment:
the null character has the code value zero and
each member of the Portable Character Set has a
code value equal to its value when used as the
lone character in an integer character constant.
wuchar_t The unsigned version of wchar_t.
mbstate_t A type that can represent the state of the
conversion between wide and multibyte characters.
wint_t An integral type that is able to store any valid
wide character value and WEOF.
wctype_t A scalar type (pointer or integer) that can hold
values which represent locale specific character
classification categories.
size_t Unsigned integral type which is the result of the
sizeof operator.
The following functions are declared by the wchar header:
int iswascii(wint_t wc);
int iswalnum(wint_t wc);
int iswalpha(wint_t wc);
int iswcntrl(wint_t wc);
int iswdigit(wint_t wc);
int iswgraph(wint_t wc);
int iswlower(wint_t wc);
int iswprint(wint_t wc);
int iswpunct(wint_t wc);
int iswspace(wint_t wc);
int iswupper(wint_t wc);
Copyright 1994 Novell, Inc. Page 1
wchar(5) wchar(5)
int iswxdigit(wint_t wc);
int isphonogram(wint_t wc);
int isideogram(wint_t wc);
int isenglish(wint_t wc);
int isnumber(wint_t wc);
int isspecial(wint_t wc);
int iswctype(wint_t wc, wctype_t prop);
int fwprintf(FILE *stream, const wchar_t *format, ...);
int fwscanf(FILE *stream, const wchar_t *format, ...);
int wprintf(const wchar_t *format, ...);
int wscanf(const wchar_t *format, ...);
int swprintf(wchar_t *s, size_t n,
const wchar_t *format, ...);
int swscanf(const wchar_t *s, const wchar_t *format,
...);
int vfwprintf(FILE *stream, const wchar_t *format,
va_list arg);
int vfwscanf(FILE *stream, const wchar_t *format,
va_list arg);
int vwprintf(const wchar_t *format, va_list arg);
int vwscanf(const wchar_t *format, va_list arg);
int vswprintf(wchar_t *s, size_t n,
const wchar_t *format, va_list arg);
int vswscanf(const wchar_t *s, const wchar_t *format,
va_listarg);
int wctob(wint_t c);
int sisinit(const mbstate_t *ps);
int mbrlen(const char *s, size_t n, mbstate_t *ps);
int mbrtowc(wchar_t *pwc, const char *s, size_t n,
mbstate_t *ps);
int wcrtomb(char *s, wchar_t wc, mbstate_t *ps);
size_t mbsrtowcs(wchar_t *dst, const char **src, size_t len,
mbstate_t *ps);
size_t wcsrtombs(char *dst, const wchar_t **src, size_t len,
mbstate_t *ps);
wint_t fgetwc(FILE *stream);
wchar_t *fgetws(wchar_t *s, int n,FILE *stream);
wint_t fputwc(wint_t c,FILE stream);
int fputws(const wchar_t s, FILE *stream);
wint_t getwc(FILE *stream);
wint_t getwchar(void);
wint_t putwc(wint_t c,FILE *stream);
wint_t putwchar(wint_t c);
wint_t towlower(wint_t wc);
wint_t towupper(wint_t wc);
wint_t ungetwc(wint_t c,FILE *stream);
Copyright 1994 Novell, Inc. Page 2
wchar(5) wchar(5)
wctype_t wctype(const char *property);
wchar_t *wcscat(wchar_t *ws1,const wchar_t *ws2);
wchar_t *wcschr(const wchar_t *ws,wint_t wc);
int wcscmp(const wchar_t *ws1,const wchar_t *ws2);
int wcscoll(const wchar_t *ws1,const wchar_t *ws2);
wchar_t *wcscpy(wchar_t *ws1,const wchar_t *ws2);
size_t wcscspn(const wchar_t *ws1,const wchar_t *ws2);
size_t wcfstime(wchar_t *wcs,size_t maxsize,
const wchar_t *fmt,const struct tm *timptr);
size_t wcslen(const wchar_t *ws1);
wchar_t *wcsncat(wchar_t *ws1,const wchar_t *ws2,size_t n);
int wcsncmp(const wchar_t *ws1,const wchar_t *ws2,
size_t n);
wchar_t *wcsncpy(wchar_t *ws1,const wchar_t *ws2,size_t n);
wchar_t *wcspbrk(const wchar_t *ws1, const wchar_t *ws2);
wchar_t *wcsrchr(const wchar_t *ws,wintr_t wc);
size_t wcsspn(const wchar_t *ws1,const wchar_t *ws2);
double wcstod(const wchar_t *nptr,wchar_t **endptr);
float wcstof(const wchar_t *nptr,wchar_t **endptr);
long double wcstold(const wchar_t *nptr,wchar_t **endptr);
wchar_t *wcstok(wchar_t *ws1,const wchar_t *ws2,
wchar_t **savept);
long int wcstol(const wchar_t *nptr,wchar_t **endptr,
int base);
unsigned long wcstoul(const wchar_t *nptr,wchar_t **endptr,
int base);
wchar_t *wcsstr(const wchar_t *ws1,const wchar_t *ws2);
int wcswidth(const wchar_t *pwcs, size_t n);
size_t wcsxfrm(wchar_t *ws1, const wchar_t *ws2,
size_t n);
int wcwidth(wint_t);
wchar defines the following macro names:
WEOF Constant expression that is returned by some of
the above functions to indicate end-of-file.
NULL Null pointer constant.
REFERENCES
locale(5)
NOTICES
If the feature test macro _XOPEN_SOURCE is defined, the
following are available:
wchar_t *wcstok(wchar_t ws1,const wchar_t *ws2);
Copyright 1994 Novell, Inc. Page 3
wchar(5) wchar(5)
wchar_t *wcswcs(const wchar_t *ws1, const wchar_t *ws2);
size_t wcsftime(wchar_t *wcs, size_t maxsize,
const char *fmt, const struct tm *timptr);
and all the symbols from stdio.h.
Copyright 1994 Novell, Inc. Page 4