wchar(5)


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); 
   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); 
   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); 
   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.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.