wchar.h.3 (6097B)
1 .TH wchar.h 3 2 .SH NAME 3 wchar.h - wide char opetarions 4 .SH SYPNOSIS 5 #include <wchar.h> 6 7 The wchar.h header declares the following functions: 8 9 .nf 10 int vswscanf(const wchar_t * restrict s, const wchar_t * restrict format, va_list arg); 11 int vwprintf(const wchar_t * restrict format, va_list arg); 12 int vwscanf(const wchar_t * restrict format, va_list arg); 13 int fwprintf(FILE * restrict stream, const wchar_t * restrict format, ...); 14 int fwscanf(FILE * restrict stream, const wchar_t * restrict format, ...); 15 int vfwprintf(FILE * restrict stream, const wchar_t * restrict format, va_list arg); 16 int vfwscanf(FILE * restrict stream, const wchar_t * restrict format, va_list arg); 17 int vswprintf(wchar_t * restrict s, size_t n, const wchar_t * restrict format, va_list arg); 18 wint_t fgetwc(FILE *stream); 19 wint_t fputwc(wchar_t c, FILE *stream); 20 wint_t getwc(FILE *stream); 21 wint_t putwc(wchar_t c, FILE *stream); 22 int fwide(FILE *stream, int mode); 23 wint_t ungetwc(wint_t c, FILE *stream); 24 wchar_t *fgetws(wchar_t * restrict s, int n, FILE * restrict stream); 25 int fputws(const wchar_t * restrict s, FILE * restrict stream); 26 int swprintf(wchar_t * restrict s, size_t n, const wchar_t * restrict format, ...); 27 int swscanf(const wchar_t * restrict s, const wchar_t * restrict format, ...); 28 int wprintf(const wchar_t * restrict format, ...); 29 int wscanf(const wchar_t * restrict format, ...); 30 wint_t getwchar(void); 31 wint_t putwchar(wchar_t c); 32 double wcstod(const wchar_t * restrict nptr, wchar_t ** restrict endptr); 33 float wcstof(const wchar_t * restrict nptr, wchar_t ** restrict endptr); 34 long double wcstold(const wchar_t * restrict nptr, wchar_t ** restrict endptr); 35 long int wcstol(const wchar_t * restrict nptr, wchar_t ** restrict endptr, int base); 36 long long int wcstoll(const wchar_t * restrict nptr, wchar_t ** restrict endptr, int base); 37 unsigned long int wcstoul(const wchar_t * restrict nptr, wchar_t ** restrict endptr, int base); 38 unsigned long long int wcstoull(const wchar_t * restrict nptr, wchar_t ** restrict endptr, int base); 39 wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2); 40 wchar_t *wcsncpy(wchar_t * restrict s1, const wchar_t * restrict s2, size_t n); 41 wchar_t *wmemcpy(wchar_t * restrict s1, const wchar_t * restrict s2, size_t n); 42 wchar_t *wmemmove(wchar_t *s1, const wchar_t *s2, size_t n); 43 wchar_t *wcscat(wchar_t * restrict s1, const wchar_t * restrict s2); 44 wchar_t *wcsncat(wchar_t * restrict s1, const wchar_t * restrict s2, size_t n); 45 int wcscmp(const wchar_t *s1, const wchar_t *s2); 46 int wcscoll(const wchar_t *s1, const wchar_t *s2); 47 int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n); 48 size_t wcsxfrm(wchar_t * restrict s1, const wchar_t * restrict s2, size_t n); 49 int wmemcmp(const wchar_t *s1, const wchar_t *s2, size_t n); 50 wchar_t *wcschr(const wchar_t *s, wchar_t c); 51 size_t wcscspn(const wchar_t *s1, const wchar_t *s2); 52 wchar_t *wcspbrk(const wchar_t *s1, const wchar_t *s2); 53 wchar_t *wcsrchr(const wchar_t *s, wchar_t c); 54 size_t wcsspn(const wchar_t *s1, const wchar_t *s2); 55 wchar_t *wcsstr(const wchar_t *s1, const wchar_t *s2); 56 wchar_t *wcstok(wchar_t * restrict s1, const wchar_t * restrict s2, wchar_t ** restrict ptr); 57 wchar_t *wmemchr(const wchar_t *s, wchar_t c, size_t n); 58 size_t wcslen(const wchar_t *s); 59 wchar_t *wmemset(wchar_t *s, wchar_t c, size_t n); 60 size_t wcsftime(wchar_t * restrict s, size_t maxsize, const wchar_t * restrict format, const struct tm * restrict timeptr); 61 wint_t btowc(int c); 62 int wctob(wint_t c); 63 int mbsinit(const mbstate_t *ps); 64 size_t mbrlen(const char * restrict s, size_t n, mbstate_t * restrict ps); 65 size_t mbrtowc(wchar_t * restrict pwc, const char * restrict s, size_t n, mbstate_t * restrict ps); 66 size_t wcrtomb(char * restrict s, wchar_t wc, mbstate_t * restrict ps); 67 size_t mbsrtowcs(wchar_t * restrict dst, const char ** restrict src, size_t len, mbstate_t * restrict ps); 68 size_t wcsrtombs(char * restrict dst, const wchar_t ** restrict src, size_t len, mbstate_t * restrict ps); 69 int wcwidth(wchar_t wc); 70 .fi 71 72 .SH DESCRIPTION 73 The wchar.h header defines the macros 74 .BR NULL , 75 .BR WCHAR_MIN , 76 and 77 .B WEOF 78 which expands to a constant expression of type 79 .B wint_t 80 whose value does not correspond to any member of the extended character set. 81 It is accepted (and returned) by several functions in this header 82 to indicate end-of-file, that is, 83 no more input from a stream. 84 It is also used as a wide character value 85 that does not correspond to any member of the extended character set. 86 .PP 87 It also defines the types 88 .BR size_t , 89 .BR wchar_t , 90 .B mbstate_t 91 which is an object type other than an array type 92 that can hold the conversion state information necessary 93 to convert between sequences of multibyte characters and wide characters; 94 .B wint_t 95 which is an integer type unchanged by default argument promotions 96 that can hold any value corresponding to members of the extended character set, 97 as well as at least one value 98 that does not correspond to any member of the extended character set 99 and 100 .B struct tm 101 which is declared as an incomplete structure type. 102 .SH STANDARDS 103 ISO/IEC 9899:1999 Section 7.24.1 104 .SH SEE ALSO 105 .BR limits (3) 106 .BR stddef.h (3) 107 .BR vswscanf (3) 108 .BR vwprintf (3) 109 .BR vwscanf (3) 110 .BR fwprintf (3) 111 .BR fwscanf (3) 112 .BR vfwprintf (3) 113 .BR vfwscanf (3) 114 .BR vswprintf (3) 115 .BR fgetwc (3) 116 .BR fputwc (3) 117 .BR getwc (3) 118 .BR putwc (3) 119 .BR fwide (3) 120 .BR ungetwc (3) 121 .BR fgetws (3) 122 .BR fputws (3) 123 .BR swprintf (3) 124 .BR swscanf (3) 125 .BR wprintf (3) 126 .BR wscanf (3) 127 .BR getwchar (3) 128 .BR putwchar (3) 129 .BR wcstod (3) 130 .BR wcstof (3) 131 .BR double wcstold (3) 132 .BR wcstol (3) 133 .BR wcstoll (3) 134 .BR wcstoul (3) 135 .BR wcstoull (3) 136 .BR wcscpy (3) 137 .BR wcsncpy (3) 138 .BR wmemcpy (3) 139 .BR wmemmove (3) 140 .BR wcscat (3) 141 .BR wcsncat (3) 142 .BR wcscmp (3) 143 .BR wcscoll (3) 144 .BR wcsncmp (3) 145 .BR wcsxfrm (3) 146 .BR wmemcmp (3) 147 .BR wcschr (3) 148 .BR wcscspn (3) 149 .BR wcspbrk (3) 150 .BR wcsrchr (3) 151 .BR wcsspn (3) 152 .BR wcsstr (3) 153 .BR wcstok (3) 154 .BR wmemchr (3) 155 .BR wcslen (3) 156 .BR wmemset (3) 157 .BR wcsftime (3) 158 .BR btowc (3) 159 .BR wctob (3) 160 .BR mbsinit (3) 161 .BR mbrlen (3) 162 .BR mbrtowc (3) 163 .BR wcrtomb (3) 164 .BR mbsrtowcs (3) 165 .BR wcsrtombs (3) 166 .BR wcwidth (3)