NAME
wchar.h —
wide-character types
SYNOPSIS
#include <wchar.h>
DESCRIPTION
The <wchar.h> header defines the
following data types through
- wchar_t
- As described in <stddef.h> .
- wint_t
- An integral type capable of storing any valid value of wchar_t , or WEOF .
- wctype_t
- A scalar type of a data object that can hold values which represent locale-specific character classification.
- mbstate_t
- 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 codeset is being used such that an mbstate_t needs to preserve more than 2 levels of reserved state, the results are unspecified.
- FILE
- As described in <stdio.h> .
- size_t
- 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.
wint_t btowc(int); int fwprintf(FILE *, const wchar_t *,
...); int fwscanf(FILE *, const wchar_t *, ...); int iswalnum(wint_t); int
iswalpha(wint_t); int iswcntrl(wint_t); int iswdigit(wint_t); int
iswgraph(wint_t); int iswlower(wint_t); int iswprint(wint_t); int
iswpunct(wint_t); int iswspace(wint_t); int iswupper(wint_t); int
iswxdigit(wint_t); int iswctype(wint_t, wctype_t); wint_t fgetwc(FILE *);
wchar_t *fgetws(wchar_t *, int, FILE *); wint_t fputwc(wchar_t, FILE *); int
fputws(const wchar_t *, FILE *); int fwide(FILE *, int); wint_t getwc(FILE
*); wint_t getwchar(void); int mbsinit(const mbstate_t *); size_t
mbrlen(const char *, size_t, mbstate_t *); size_t mbrtowc(wchar_t *, const
char *, size_t, mbstate_t *); size_t mbsrtowcs(wchar_t *, const char **,
size_t, mbstate_t *); wint_t putwc(wchar_t, FILE *); wint_t
putwchar(wchar_t); int swprintf(wchar_t *, size_t, const wchar_t *, ...);
int swscanf(const wchar_t *, const wchar_t *, ...); wint_t towlower(wint_t);
wint_t towupper(wint_t); wint_t ungetwc(wint_t, FILE *); int vfwprintf(FILE
*, const wchar_t *, va_list); int vwprintf(const wchar_t *, va_list); int
vswprintf(wchar_t *, size_t, const wchar_t *, va_list); size_t wcrtomb(char
*, wchar_t, mbstate_t *); wchar_t *wcscat(wchar_t *, const wchar_t *);
wchar_t *wcschr(const wchar_t *, wchar_t); int wcscmp(const wchar_t *, const
wchar_t *); int wcscoll(const wchar_t *, const wchar_t *); wchar_t
*wcscpy(wchar_t *, const wchar_t *); size_t wcscspn(const wchar_t *, const
wchar_t *); size_t wcsftime(wchar_t *, size_t, const wchar_t *, const struct
tm *); size_t wcslen(const wchar_t *); wchar_t *wcsncat(wchar_t *, const
wchar_t *, size_t); int wcsncmp(const wchar_t *, const wchar_t *, size_t);
wchar_t *wcsncpy(wchar_t *, const wchar_t *, size_t); wchar_t *wcspbrk(const
wchar_t *, const wchar_t *); wchar_t *wcsrchr(const wchar_t *, wchar_t);
size_t wcsrtombs(char *, const wchar_t **, size_t, mbstate_t *); size_t
wcsspn(const wchar_t *, const wchar_t *); wchar_t *wcsstr(const wchar_t *,
const wchar_t *); double wcstod(const wchar_t *, wchar_t **); wchar_t
*wcstok(wchar_t *, const wchar_t *, wchar_t **); long int wcstol(const
wchar_t *, wchar_t **, int); unsigned long int wcstoul(const wchar_t *,
wchar_t **, int); wchar_t *wcswcs(const wchar_t *, const wchar_t *); int
wcswidth(const wchar_t *, size_t); size_t wcsxfrm(wchar_t *, const wchar_t
*, size_t); int wctob(wint_t); wctype_t wctype(const char *); int
wcwidth(wchar_t); wchar_t *wmemchr(const wchar_t *, wchar_t, size_t); int
wmemcmp(const wchar_t *, const wchar_t *, size_t); wchar_t *wmemcpy(wchar_t
*, const wchar_t *, size_t); wchar_t *wmemmove(wchar_t *, const wchar_t *,
size_t); wchar_t *wmemset(wchar_t *, wchar_t, size_t); int wprintf(const
wchar_t *, ...); int wscanf(const wchar_t *, ...);
<wchar.h> defines the following macro names:
- WCHAR_MAX
- The maximum value representable by an object of type wchar_t .
- WCHAR_MIN
- The minimum value representable by an object of type wchar_t .
- WEOF
- Constant expression of type wint_t 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>.
APPLICATION USAGE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
btowc(3) , fwprintf(3) , fwscanf(3) , iswalnum(3) , iswalpha(3) , iswcntrl(3) , iswdigit(3) , iswgraph(3) , iswlower(3) , iswprint(3) , iswpunct(3) , iswspace(3) , iswupper(3) , iswxdigit(3) , iswctype(3) , fgetwc(3) , fgetws(3) , fputwc(3) , fputws(3) , fwide(3) , getwc(3) , getwchar(3) , mbsinit(3) , mbrlen(3) , mbrtowc(3) , mbsrtowcs(3) , putwc(3) , putwchar(3) , swprintf(3) , swscanf(3) , towlower(3) , towupper(3) , ungetwc(3) , vfwprintf(3) , vwprintf(3) , vswprintf(3) , wcrtomb(3) , wcsrtombs(3) , wcscat(3) , wcschr(3) , wcscmp(3) , wcscoll(3) , wcscpy(3) , wcscspn(3) , wcsftime(3) , wcslen(3) , wcsncat(3) , wcsncmp(3) , wcsncpy(3) , wcspbrk(3) , wcsrchr(3) , wcsspn(3) , wcsstr(3) , wcstod(3) , wcstok(3) , wcstol(3) , wcstoul(3) , wcswcs(3) , wcswidth(3) , wcsxfrm(3) , wctob(3) , wctype(3) , wcwidth(3) , wmemchr(3) , wmemcmp(3) , wmemcpy(3) , wmemmove(3) , wmemset(3) , wprintf(3) , wscanf(3) , <ctype.h> , <stdio.h> , <stdarg.h> , <stdlib.h> , <string.h> , <stddef.h> and <time.h> .