scc

simple c99 compiler
git clone git://git.simple-cc.org/scc
Log | Files | Refs | Submodules | README | LICENSE

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)